# 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.

---

## 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.

### [Gateway Bancário](https://www.kobana.com.br/produtos/gateway-bancario)

Boletos, Pix, Pix Automático, pagamentos, transferências, extrato, remessa e retorno, nas versões v1 e v2. Tem SDKs oficiais em Ruby, PHP, Python e Node.js.

- URL base (Produção): `https://api.kobana.com.br`
- URL base (Sandbox): `https://api.sandbox.kobana.com.br`
- [Documentação da API](https://docs.banking.kobana.com.br/pt/api/overview)
- [Especificação OpenAPI](https://raw.githubusercontent.com/universokobana/kobana-api-specs/refs/heads/main/swagger/all-versions/kobana-api-all-versions-openapi-3_1.json)
- [Coleção do Postman](https://www.postman.com/universokobana/kobana-api/overview)

### [Faturamento Automático](https://www.kobana.com.br/produtos/faturamento-automatico)

Clientes, planos, assinaturas, faturas, pagamentos, notas fiscais, propostas e consumo.

- URL base (Produção): `https://api.billing.kobana.com.br`
- URL base (Sandbox): `https://api.billing.sandbox.kobana.com.br`
- [Documentação da API](https://docs.billing.kobana.com.br/pt/api/overview)
- [Especificação OpenAPI](https://docs.billing.kobana.com.br/pt/openapi/openapi-v1-pt.yaml)
- [Coleção do Postman](https://docs.billing.kobana.com.br/pt/postman/postman-v1-pt.json)

### [Financeiro Inteligente](https://www.kobana.com.br/produtos/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`
- [Documentação da API](https://docs.finance.kobana.com.br/pt/api/overview)
- [Especificação OpenAPI](https://docs.finance.kobana.com.br/pt/openapi/openapi-v1-pt.yaml)
- [Coleção do Postman](https://docs.finance.kobana.com.br/pt/postman/postman-v1-pt.json)

### [Régua de Cobrança](https://www.kobana.com.br/produtos/regua-de-cobranca)

Clientes, cobranças, réguas, acordos, disputas, tarefas, importações e webhooks.

- URL base (Produção): `https://api.dunning.kobana.com.br`
- [Documentação da API](https://docs.dunning.kobana.com.br/pt/api/overview)
- [Especificação OpenAPI](https://docs.dunning.kobana.com.br/pt/openapi/openapi-v1-pt.yaml)
- [Coleção do Postman](https://docs.dunning.kobana.com.br/pt/postman/postman-v1-pt.json)

### [Dashboard Mágico](https://www.kobana.com.br/produtos/dashboard-magico)

Organização, usuários do portal, entidades, conectores, chaves de API e webhooks.

- URL base (Produção): `https://api.dashboards.kobana.com.br`
- [Documentação da API](https://docs.dashboards.kobana.com.br/pt/api/overview/introduction)
- [Especificação OpenAPI](https://docs.dashboards.kobana.com.br/pt/openapi/openapi-v1-pt.yaml)
- [Coleção do Postman](https://docs.dashboards.kobana.com.br/pt/postman/postman-v1-pt.json)

### [Inbox Autônomo](https://docs.inbox.kobana.com.br/pt/)

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`
- [Documentação da API](https://docs.inbox.kobana.com.br/pt/api/overview/introduction)
- [Especificação OpenAPI](https://docs.inbox.kobana.com.br/pt/openapi/openapi-v1-pt.yaml)

### [Agente Kadu](https://docs.kadu.ia.br/pt/)

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`
- [Documentação da API](https://docs.kadu.ia.br/pt/api/overview/introduction)
- [Especificação OpenAPI](https://docs.kadu.ia.br/pt/openapi/openapi-v1.yaml)

## 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](https://www.kobana.com.br/desenvolvedores/sdks)

## Depois da primeira chamada

- **[Servidores MCP](https://www.kobana.com.br/desenvolvedores/mcp)**: Dê a um agente de IA acesso ao mesmo recurso, com as permissões de quem autorizou.
- **[CLI](https://cli.kobana.com.br/pt/)**: Automatize no terminal e em pipelines de CI, sem escrever o cliente HTTP.
- **[Webhooks](https://docs.banking.kobana.com.br/pt/api/overview/webhooks)**: Receba eventos em tempo real, com assinatura HMAC, no Gateway Bancário, no Faturamento, na Régua de Cobrança e no Dashboard Mágico.
- **[Sandbox](https://www.kobana.com.br/desenvolvedores/sandbox)**: Teste sem mover dinheiro de verdade.

---

## Precisa de ajuda para integrar?

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

[Agendar bate-papo](https://www.kobana.com.br/agendar)
