Pular para o conteúdo principal

Introdução

kobana é uma ferramenta de linha de comando única para a API de todos os produtos Kobana — incluindo o Inbox Autônomo. Ela é construída e mantida em seu próprio repositório (kobana-cli), não por este produto, e não tem endpoints fixos no código: na inicialização ela interpreta as specs OpenAPI 3.1 embutidas no binário e monta sua árvore de comandos a partir delas. Atualizar a superfície da API é uma questão de atualizar a spec embutida e publicar um novo build — sem código por endpoint.

kobana <produto> <recurso> <método> [flags]

Projetado para humanos e agentes de IA: saída JSON estruturada por padrão, introspecção de schema, --dry-run e paginação automática.

Produtos​

ProdutoDescriçãoStatus
bankingGateway Bancário — cobranças, pagamentos, transferências (API v1 e v2)Disponível
inboxInbox Autônomo — inboxes, agents, e-mails, webhooks (esta API)Disponível
financeFinanceiro Inteligente — contas a pagar e a receber, lançamentos, fluxo de caixaDisponível
billingFaturamento Automático — assinaturas, planos, faturas, notas fiscaisDisponível

O produto inbox fala com a mesma API documentada neste site. Seus recursos — workspaces, inboxes, emails, agents, agent-runs, webhooks, system-events — mapeiam diretamente para os Modelos e Recursos da Referência da API; o CLI é apenas mais uma forma de chamá-la. Ele não compartilha credenciais nem transporte com o banking — veja Autenticação.

Primeiros passos​

  1. Instale — veja Instalação.

  2. Autentique-se para o produto que você precisa — um Bearer token para inbox, OAuth ou um token para banking. Veja Autenticação.

  3. Faça sua primeira chamada:

    kobana inbox workspaces list --fields "id,name"

  4. Explore a superfície — todo comando aceita --help, e kobana schema introspecciona os parâmetros e o corpo de qualquer endpoint sem sair do terminal.

Próximos passos​