Skip to main content

​
Token Bearer

A API usa tokens Bearer. Gere seu token no painel do vendedor em Integrações (/vendedor/integracoes) e envie em todas as requisições: 
curl https://akeba.com.br/api/v1/ping \
  -H "Authorization: Bearer SEU_TOKEN"
Resposta: 
{ "pong": true, "loja_id": "9d3f2c1a-..." }
O token é exibido uma única vez ao ser gerado. Guarde-o em local seguro. Tokens podem ser revogados a qualquer momento no painel de integrações.
O token identifica a loja: todos os endpoints retornam e operam apenas sobre dados da loja autenticada. Tentar acessar recursos de outra loja retorna 404.

​
Limite de requisições

  • 120 requisições por minuto por loja.
  • Ao exceder o limite, a API retorna 429 Too Many Requests.
  • Use a sincronização incremental para reduzir o volume de chamadas.

​
Boas práticas

Nunca exponha o token

Armazene o token em variáveis de ambiente ou cofre de segredos — nunca no código-fonte ou no front-end.

Revogue tokens comprometidos

Se um token vazar, revogue-o imediatamente no painel de integrações e gere um novo.