Introducción
kobana es una única herramienta de línea de comandos para las APIs de todos los productos Kobana — Finanzas Inteligentes incluido. Se construye y mantiene en su propio repositorio (kobana-cli), no en este producto, y no tiene ningún endpoint escrito a mano: al arrancar lee las specs OpenAPI 3.1 embebidas en el binario y arma su árbol de comandos a partir de ellas. Actualizar la superficie de la API es cuestión de refrescar la spec embebida y publicar un build nuevo — nada de código por endpoint.
kobana <producto> <recurso> <metodo> [flags]
Pensada tanto para personas como para agentes de IA: salida JSON estructurada por defecto, introspección de schema, --dry-run y paginación automática.
Productos
| Producto | Descripción |
|---|---|
banking | Gateway Bancario — cobros, pagos, transferencias (API v1 y v2) |
finance | Finanzas Inteligentes — cuentas por pagar y por cobrar, movimientos, flujo de caja |
billing | Facturación Automática — suscripciones, planes, facturas, notas fiscales |
inbox | Inbox Autónomo — casillas de entrada, agentes, correos, webhooks |
El producto finance habla con la misma API documentada en este sitio. Sus recursos — mira el catálogo completo — apuntan a los mismos endpoints de la Referencia de la API; el CLI es solo otra forma de llamarla. No comparte credenciales con los otros productos: mira Autenticación.
Comenzando
-
Instálalo — mira Instalación.
-
Autentícate en el producto que vas a usar. Mira Autenticación.
-
Haz la primera llamada:
kobana finance financial-accounts list --fields "id,name,balance" -
Explora la superficie — todo comando acepta
--help, ykobana schemamuestra parámetros y cuerpo de cualquier endpoint sin salir de la terminal.
Próximos pasos
- Instalación — Homebrew, binarios precompilados, Nix, build desde el source.
- Autenticación — tokens, ambientes y las credenciales propias de
finance. - Uso — sintaxis, recursos, ejemplos.
- Introspección de schema —
kobana schemapara parámetros y formato de solicitud y respuesta. - Flags globales — las flags que acepta todo comando.
- Helpers — atajos
+verbopara flujos comunes. - Variables de ambiente — autenticación, configuración y logs.
- Códigos de salida — códigos de salida del proceso, para scripts.