Quickstart - Akeba

Este guia leva você do zero à primeira chamada autenticada: gerar um token, testar a conexão e listar seus pedidos.

Pré-requisitos

Uma conta de vendedor ativa na Akeba
Uma ferramenta para fazer requisições HTTP (curl, Postman, Insomnia ou seu ERP)

Gere seu token de API

Acesse o painel do vendedor em Integrações e clique em Gerar token.

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.

Teste a conexão

Chame o endpoint GET /ping enviando o token no header Authorization:

curl https://akeba.com.br/api/v1/ping \
  -H "Authorization: Bearer SEU_TOKEN"

Se tudo estiver certo, a resposta identifica a sua loja:

{ "pong": true, "loja_id": "9d3f2c1a-..." }

Liste seus pedidos

Busque os itens de pedido pendentes de aceite:

curl "https://akeba.com.br/api/v1/pedidos?status=pending" \
  -H "Authorization: Bearer SEU_TOKEN"

Aceite um item

Use os IDs retornados no passo anterior para aceitar um item e iniciar o fluxo de entrega:

curl -X POST \
  "https://akeba.com.br/api/v1/pedidos/{pedidoId}/itens/{itemId}/aceitar" \
  -H "Authorization: Bearer SEU_TOKEN"

Entenda como o token funciona e os limites de requisição.

O ciclo completo de um item: do pagamento à entrega.

Receba eventos em tempo real em vez de consultar a API repetidamente.

Códigos de status e como tratar cada tipo de erro.

⌘I