Kobana

APIs REST para cada produto Kobana

Um padrão só em todos os produtos: JSON, tokens Bearer, idempotência. Escolha o produto, copie a URL base e faça a primeira chamada.

APIs REST para cada produto Kobana

O mesmo padrão em todos os produtos

Aprendeu uma API da Kobana, aprendeu todas.

  • JSON e snake_case: Requisições e respostas em JSON, com campos em snake_case e datas em ISO 8601.
  • Valores em reais: Valores monetários como número em reais (149.90), nunca em centavos.
  • Bearer token: Authorization: Bearer <token>, emitido pela Conta Kobana. Cada produto documenta os escopos.
  • Idempotência: Envie X-Idempotency-Key nas criações: repetir a chamada devolve o resultado da primeira.
  • Sandbox: Gateway Bancário, Faturamento Automático e Financeiro Inteligente têm um ambiente de testes separado da produção, para validar antes de ir ao ar.
  • Limite de requisições: Acima do limite, a API responde 429. Trate a resposta com nova tentativa e espera.

APIs por produto

URL base, um exemplo de chamada e a documentação completa de cada produto.

Financeiro Inteligente

Contas a pagar e a receber, lançamentos, conciliação, contas financeiras, fluxo de caixa e cadastros.

Informe o workspace no cabeçalho X-Workspace-Id.

URL base · Produção
https://api.finance.kobana.com.br/v1
URL base · Sandbox
https://api.finance.sandbox.kobana.com.br/v1

Exemplo

curl https://api.finance.kobana.com.br/v1/financial-accounts \
  -H "Authorization: Bearer $KOBANA_TOKEN" \
  -H "X-Workspace-Id: $WORKSPACE_ID"

Inbox Autônomo

Workspaces, caixas de entrada, e-mails, agentes, execuções de agentes, webhooks e consumo.

Além do Bearer token, exige um certificado de cliente (mTLS). Paginação por cursor; com mais de um workspace, informe X-Workspace-Id.

URL base · Produção
https://api.inbox.kobana.com.br

Exemplo

curl "https://api.inbox.kobana.com.br/v1/inboxes?limit=5" \
  --cert client.pem \
  -H "Authorization: Bearer $KOBANA_TOKEN"

Agente Kadu

Tarefas, execuções, pendências, ambientes, secrets, agendamentos, webhooks e consumo.

Sem sandbox: use um ambiente do próprio Kadu para testar. Paginação por cursor.

URL base · Produção
https://api.kadu.ia.br/v1

Exemplo

curl "https://api.kadu.ia.br/v1/tasks?limit=5" \
  -H "Authorization: Bearer $KOBANA_TOKEN"

SDKs oficiais para cada produto

Bibliotecas em Node.js, Python, Ruby e PHP para não montar as requisições à mão. O Gateway Bancário já tem os quatro; os demais produtos chegam em breve.

Ver os SDKs

Precisa de ajuda para integrar?

Fale com o nosso time de engenharia sobre o seu caso.