Introducción
kobana es una única herramienta de línea de comandos para las APIs de todos los productos Kobana — Dashboard Mágico 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 |
dunning | Cobranza — deudores, cobros, flujos de cobranza, acuerdos, reportes a burós |
dashboards | Dashboard Mágico — fuentes de datos, entidades, portal, workspaces |
El producto dashboards 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 Dashboard Mágico y, si la organización tiene más de un workspace, elige en cuál actuar. Mira Autenticación.
-
Haz la primera llamada:
kobana dashboards data-sources list --fields "id,name,kind,status" -
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 — token, workspace y ambientes de
dashboards. - 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.