Autenticação

Todas as requisições à API exigem autenticação via bearer token.

Base URL

https://services.antonnia.com/conversations/v2/api/v1

Bearer token

Inclua seu token de API no header Authorization:

Authorization: Bearer sk_live_YOUR_TOKEN

Exemplo

curl -X GET https://services.antonnia.com/conversations/v2/api/v1/sessions/sess_abc123 \
  -H "Authorization: Bearer sk_live_YOUR_TOKEN"

import httpx

BASE_URL = "https://services.antonnia.com/conversations/v2/api/v1"
HEADERS = {
    "Authorization": "Bearer sk_live_YOUR_TOKEN",
    "Content-Type": "application/json",
}

response = httpx.get(f"{BASE_URL}/sessions/sess_abc123", headers=HEADERS)

Obtendo um token

Seu token de API (sk_live_...) é fornecido pela equipe da Antonnia durante o onboarding. O token é vinculado à sua organização — todos os recursos acessados com ele devem pertencer a essa organização.

Respostas de erro

401 Unauthorized

{
  "detail": "Invalid or expired token"
}

Causas:

• Header Authorization ausente
• Formato de token inválido
• Token expirado
• Token não corresponde à organização proprietária do recurso solicitado

Escopo por organização

Toda requisição à API é vinculada à organização associada ao seu token. Você só pode acessar recursos (sessões, mensagens, agentes) que pertencem à sua organização. Tentar acessar recursos de outra organização retorna 401.