Autenticação

​

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

Authorization: Bearer macaly_your_api_key_here

​

Exemplo de requisição

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

​

Boas práticas de segurança

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

• 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