Introducción

precaución

La CLI de Debi está en beta. Esta página cubre los comandos de tooling. Los flags exactos pueden cambiar; usá debi <comando> --help.

debi es la interfaz de línea de comandos para la API de Debi. Sirve para autenticarte, llamar cualquier endpoint y probar webhooks en tu máquina.

El código y las opciones de instalación completas están en github.com/debipro/cli.

Instalar

En macOS, el camino más corto es Homebrew:

brew install debipro/tap/debi

Binarios, Docker, Scoop, paquetes Linux y go install están documentados en el README del repositorio.

Autenticarse

Creá una secret key en el dashboard de developers y guardala en el keychain del sistema:

debi login

También podés pasar --api-key sk_test_... o definir DEBI_API_KEY. El entorno (test / live) se infiere del prefijo de la key; --test y --live fuerzan api.debi-test.pro y api.debi.pro.

Primera llamada

debi --test customers list --limit 5

Si un comando de recurso no aparece, corré debi spec update para refrescar la spec OpenAPI embebida. El detalle de flags está en la referencia.

Webhooks en local

Debi no empuja eventos al CLI. debi listen levanta un servidor HTTP local; los eventos llegan porque los reenviás vos.

1. Receptor local:

debi listen 4242 --webhook-secret whsec_...

2. Polling de la API de eventos y reenvío a ese receptor:

debi events tail --forward-to http://127.0.0.1:4242/ --webhook-secret whsec_...

--forward-to solo acepta localhost / 127.0.0.1. Si necesitás una URL pública para el dashboard, usá un túnel (ngrok, cloudflared) frente a debi listen.

La configuración de webhooks en el panel está en Introducción a los Webhooks.