Autenticação
Aprenda como autenticar com a API Arkangel AI usando chaves de API
by Arkangel AI Team•1 min read
A API Arkangel AI usa chaves de API para autenticar solicitações. Você pode ver e gerenciar suas chaves de API no painel da sua conta.
Obtendo Sua Chave de API
- Faça login na sua conta Arkangel AI
- Vá para Configurações > API
- Clique em Gerar Nova Chave de API
- Copie e armazene sua chave com segurança
Importante: Sua chave de API é secreta. Não a compartilhe nem a exponha em código do lado do cliente.
Usando Sua Chave de API
Inclua sua chave de API no cabeçalho Authorization de todas as solicitações:
curl -X POST https://api.arkangelai.com/v1/chat \
-H "Authorization: Bearer sua_chave_api" \
-H "Content-Type: application/json" \
-d '{"message": "Olá"}'
Exemplo JavaScript
const response = await fetch('https://api.arkangelai.com/v1/chat', {
method: 'POST',
headers: {
'Authorization': 'Bearer sua_chave_api',
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: 'Olá'
})
});
Exemplo Python
import requests
headers = {
'Authorization': 'Bearer sua_chave_api',
'Content-Type': 'application/json'
}
response = requests.post(
'https://api.arkangelai.com/v1/chat',
headers=headers,
json={'message': 'Olá'}
)
Segurança das Chaves de API
- Nunca exponha sua chave de API em código do lado do cliente
- Use variáveis de ambiente para armazenar suas chaves
- Faça rotação das suas chaves regularmente
- Revogue imediatamente qualquer chave comprometida
Variáveis de Ambiente
# .env
ARKANGEL_API_KEY=sua_chave_api
// Usar a variável de ambiente
const apiKey = process.env.ARKANGEL_API_KEY;
Erros de Autenticação
| Código | Mensagem | Descrição |
|---|---|---|
| 401 | invalid_api_key |
A chave de API fornecida é inválida |
| 401 | missing_api_key |
Nenhuma chave de API foi fornecida |
| 403 | api_key_revoked |
A chave de API foi revogada |
| 429 | rate_limit_exceeded |
Você excedeu o limite de solicitações |
Próximos Passos
- Enviar e Receber Mensagens - Aprenda a interagir com a API
- Referência HTTP - Veja todos os códigos de status