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

> Aprende a autenticar-te na API da Macaly com chaves API

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

A API da Macaly usa chaves API para autenticação. As chaves API são associadas a uma equipa e partilham o mesmo sistema de créditos que a interface web.

## Obter uma chave API

1. Inicia sessão na tua conta Macaly
2. Clica no teu perfil (canto superior direito)
3. Vai a **Definições → Chaves API**
4. Clica em "Criar nova chave API"
5. Copia a chave imediatamente (só é mostrada uma vez)

## Usar a chave API

Inclui a chave API no cabeçalho `Authorization` em todos os pedidos:

```
Authorization: Bearer macaly_your_api_key_here
```

### Exemplo de pedido

```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 API

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

## Boas práticas de segurança

<Warning>
  As chaves API dão acesso total aos recursos e créditos da tua equipa. Trata-as como palavras-passe.
</Warning>

1. **Guarda as chaves em segurança** - Usa variáveis de ambiente, nunca as incluas no código
2. **Renova as chaves regularmente** - Revoga e recria chaves periodicamente
3. **Usa chaves separadas** - Cria chaves diferentes para diferentes ambientes/aplicações
4. **Monitoriza o uso** - Verifica o teu saldo regularmente através do painel
5. **Revoga chaves comprometidas** - Se uma chave for exposta, revoga-a imediatamente

## Limites de pedidos

* As tentativas falhadas com a chave API estão sujeitas a um limite de 5 por minuto por endereço IP
* Isto protege contra ataques de força bruta

## Gestão de chaves

Podes gerir as tuas chaves API no painel da Macaly:

* **Ver chaves** - Vê todas as chaves ativas com a respetiva data de criação e última utilização
* **Criar chaves** - Gera novas chaves com nomes opcionais para identificação
* **Revogar chaves** - Desativa chaves que já não são necessárias ou que foram comprometidas


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