Voltar à documentação

Autenticação

Aprenda como autenticar com a API Arkangel AI usando chaves de API

por Arkangel AI Team•1 min de leitura

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