Autenticação

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

1. Faça login na sua conta Arkangel AI
2. Vá para Configurações > API
3. Clique em Gerar Nova Chave de API
4. 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