Introdução
kobana é uma ferramenta de linha de comando única para as APIs de todos os produtos Kobana — o Financeiro Inteligente incluído. Ela é construída e mantida em repositório próprio (kobana-cli), não por este produto, e não tem endpoint algum escrito à mão: na inicialização ela lê as specs OpenAPI 3.1 embutidas no binário e monta a árvore de comandos a partir delas. Atualizar a superfície da API é questão de atualizar a spec embutida e publicar um build novo — nenhum código por endpoint.
kobana <produto> <recurso> <metodo> [flags]
Pensada tanto para pessoas quanto para agentes de IA: saída JSON estruturada por padrão, introspecção de schema, --dry-run e paginação automática.
Produtos
| Produto | Descrição |
|---|---|
banking | Gateway Bancário — cobranças, pagamentos, transferências (API v1 e v2) |
finance | Financeiro Inteligente — contas a pagar e a receber, lançamentos, fluxo de caixa |
billing | Faturamento Automático — assinaturas, planos, faturas, notas fiscais |
inbox | Inbox Autônomo — caixas de entrada, agentes, e-mails, webhooks |
O produto finance fala com a mesma API documentada neste site. Os recursos dele — veja o catálogo completo — apontam para os mesmos endpoints da Referência da API; o CLI é só mais um jeito de chamá-la. Ele não compartilha credenciais com os outros produtos: veja Autenticação.
Começando
-
Instale — veja Instalação.
-
Autentique-se no produto que você vai usar. Veja Autenticação.
-
Faça a primeira chamada:
kobana finance financial-accounts list --fields "id,name,balance" -
Explore a superfície — todo comando aceita
--help, ekobana schemamostra parâmetros e corpo de qualquer endpoint sem sair do terminal.
Próximos passos
- Instalação — Homebrew, binários prontos, Nix, build a partir do source.
- Autenticação — tokens, ambientes e as credenciais próprias do
finance. - Uso — sintaxe, recursos, exemplos.
- Introspecção de schema —
kobana schemapara parâmetros e formato de requisição e resposta. - Flags globais — as flags que todo comando aceita.
- Helpers — atalhos
+verbopara fluxos comuns. - Variáveis de ambiente — autenticação, configuração e logs.
- Códigos de saída — códigos de saída do processo, para scripts.