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

# Autenticação

> Como se autenticar na API do Macaly com chaves de API

<Callout icon="user">
  Disponível apenas no [plano **Agência**](/docs/pt-BR/welcome/pricing)
</Callout>

A API do Macaly usa chaves de API para autenticação. As chaves são vinculadas ao workspace e compartilham o mesmo sistema de créditos da interface web.

## Como obter uma chave de API

1. Entre na sua conta do Macaly
2. Clique no seu perfil (canto superior direito)
3. Vá em **Configurações → Chaves de API**
4. Clique em "Criar nova chave de API"
5. Copie a chave imediatamente (ela é exibida apenas uma vez)

## Como usar a chave de API

Envie a chave de API no cabeçalho `Authorization` de todas as requisições:

```
Authorization: Bearer macaly_your_api_key_here
```

### Exemplo de requisição

```bash theme={null}
curl -X POST https://www.macaly.com/api/chat \
  -H "Authorization: Bearer macaly_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"content": "Create a landing page"}'
```

## Formato da chave de API

| Propriedade | Valor |
| - | - |
| Prefixo | `macaly_` |
| Comprimento total | 39 caracteres |
| Exemplo | `macaly_abc123def456ghi789jkl012mno345` |

## Boas práticas de segurança

<Warning>
  As chaves de API dão acesso total aos recursos e aos créditos do seu workspace. Trate-as como senhas.
</Warning>

1. **Guarde as chaves com segurança**: use variáveis de ambiente e nunca as inclua no código
2. **Troque as chaves com regularidade**: revogue e recrie as chaves periodicamente
3. **Use chaves separadas**: crie uma chave diferente para cada ambiente ou aplicação
4. **Acompanhe o uso**: confira seu saldo com frequência no painel
5. **Revogue chaves comprometidas**: se uma chave for exposta, revogue-a imediatamente

## Limites de requisições

* Tentativas com chave de API inválida são limitadas a 5 por minuto por IP
* Isso protege contra ataques de força bruta

## Gerenciamento de chaves

Você pode gerenciar suas chaves de API no painel do Macaly:

* **Ver chaves**: veja todas as chaves ativas, com a data de criação e o horário do último uso
* **Criar chaves**: gere novas chaves, com um nome opcional para identificação
* **Revogar chaves**: desative chaves que não são mais necessárias ou que foram comprometidas


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.