> ## 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.

# Autenticação

> Autentique requisições da API Hyze Cloud com uma API key Bearer.

Endpoints privados exigem uma API key no header `Authorization`.

```http theme={"system"}
Authorization: Bearer hyze_sua_chave
```

## Criar uma key

1. Abra [hyzecloud.com/dashboard](http://hyzecloud.com/dashboard)
2. **Settings → API Keys → Create Key**
3. Copie o secret uma vez (`hyze_...`)

Keys ficam ligadas a um **workspace**. As requisições usam os recursos desse workspace.

## Exemplo

```bash theme={"system"}
curl https://api.hyzecloud.com/api/apps/ \
  -H "Authorization: Bearer hyze_sua_chave"
```

Com a SDK, passe a key uma vez:

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

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

## Boas práticas

* Guarde keys em variáveis de ambiente (`HYZE_API_KEY`), nunca no código ou no front-end
* Use uma key por ambiente ou automação (CI, local, tooling de produção)
* Revogue keys que não usa mais

## Relacionado

* [Quickstart](/pt/quickstart) — validar se a key funciona
* [Endpoints de API keys](/api-reference/api-keys) — criar e gerenciar via API
* [Workspaces](/pt/concepts/workspaces) — acesso multi-time