Documentação

Tudo o que é necessário pra integrar com o Athelium. Auth, contrato da API, formas de consumo e referência de erros.

Quickstart

~60 segundos

Substitua <sua_api_key> pela key fornecida pela curadoria. URL do gateway é específica do seu ambiente — confirme com a curadoria.

terminalbash

curl -X POST https://gateway.athelium.com.br/api/v1/compose \
  -H "Authorization: Bearer <sua_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "intent": "Como qualifico um lead inbound?"
  }'

Resposta esperada:

json

{
  "execution_id": "904add19-...",
  "composed_context": "## Contexto\n\n### Diretrizes\n...\n_fonte: skill_id=...",
  "skills_used": ["af499ec8-...", "51e7c053-..."],
  "tokens_in": 1185,
  "tokens_out": 1264,
  "cached": false
}

Funcionou? Pule pra HTTP direto pra ver todos os parâmetros, ou MCP se prefere consumir via Claude Desktop / Cursor / Continue.

Qual canal usar?

MCP

Quando o consumo é manual (dev usando Claude Desktop, Cursor ou Continue no dia-a-dia).

HTTP direto

Quando a integração roda em backend service, job, microsserviço — qualquer código que faz HTTP.

Webhook

Quando a automação está em ferramenta low-code (Zapier, Make, n8n, Power Automate).

O que a API entrega

O endpoint principal é POST /api/v1/compose: recebe um intent, devolve o contexto curado já estruturado em markdown, pronto pra dropar no LLM da sua escolha. Cada bloco do contexto cita a skill de origem (proveniência).

Existe também POST /api/v1/serve, conveniência que combina o compose com o modelo do framework numa única chamada — útil quando o objetivo é resposta direta sem mandar o contexto pra outro LLM.

Referência rápida

Autenticação

Bearer, X-API-Key, query param. Quando usar cada um.

Erros & limites

Códigos de erro, rate limits, payload e timeouts.