> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyzecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral

> Clientes oficiais da API Hyze Cloud — SDKs tipadas para Node.js, Bun e mais.

As SDKs oficiais encapsulam a REST API da Hyze Cloud com helpers tipados, erros consistentes e menos boilerplate.

A API continua sendo a fonte da verdade. As SDKs cobrem as superfícies principais: apps, databases, API keys, invoices, GitHub e plans.

## Pacotes oficiais

| Pacote                                  | Runtime          | Status         | Docs                        |
| --------------------------------------- | ---------------- | -------------- | --------------------------- |
| [`@hyzecloud/sdk`](/pt/sdks/typescript) | Node.js 18+, Bun | **Disponível** | [Guia](/pt/sdks/typescript) |
| Python                                  | Python 3.10+     | Em breve       | —                           |

## Instalação (Node / Bun)

```bash theme={"system"}
npm install @hyzecloud/sdk
# ou
bun add @hyzecloud/sdk
```

```ts theme={"system"}
import { HyzeCloud } from "@hyzecloud/sdk";

const hyze = new HyzeCloud({
  apiKey: process.env.HYZE_API_KEY, // hyze_...
});

const { apps } = await hyze.apps.list();
```

## Quando usar uma SDK

* Quer helpers tipados de request/response
* Prefere `hyze.apps.restart(id)` em vez de `fetch` cru
* Precisa de erros consistentes (`HyzeError`, rate limits)

Use a [API Reference](/api-reference/introduction) (ou curl) quando quiser controle total ou uma linguagem sem SDK ainda.

## Código e npm

* npm: [`@hyzecloud/sdk`](https://www.npmjs.com/package/@hyzecloud/sdk)
* GitHub: [hyze-cloud/hyzecloud-sdk-ts](https://github.com/hyze-cloud/hyzecloud-sdk-ts)

## Próximos passos

<CardGroup cols={2}>
  <Card title="TypeScript / Node / Bun" icon="code" href="/pt/sdks/typescript">
    Guia completo do @hyzecloud/sdk.
  </Card>

  <Card title="Autenticação" icon="key" href="/pt/getting-started/authentication">
    Criar e usar API keys.
  </Card>

  <Card title="Referência da API" icon="book-open" href="/api-reference/introduction">
    Todos os endpoints REST.
  </Card>

  <Card title="Quickstart" icon="rocket" href="/pt/quickstart">
    Primeiro deploy em minutos.
  </Card>
</CardGroup>
