Endpoints de webhook
Las URLs que reciben los eventos de Régua de Cobrança (charge.paid, agreement.accepted…). rotate-secret genera un nuevo secret HMAC, test entrega un evento webhook.test real, y deliveries lista las entregas y reencola una que falló.
| Comando | HTTP | Descripción |
|---|---|---|
webhook-endpoints list | GET /v1/webhook-endpoints | Listar endpoints de webhook |
webhook-endpoints create | POST /v1/webhook-endpoints | Crear endpoint de webhook |
webhook-endpoints get | GET /v1/webhook-endpoints/{id} | Consultar endpoint de webhook |
webhook-endpoints update | PATCH /v1/webhook-endpoints/{id} | Actualizar endpoint de webhook |
webhook-endpoints delete | DELETE /v1/webhook-endpoints/{id} | Eliminar endpoint de webhook |
webhook-endpoints rotate-secret | POST /v1/webhook-endpoints/{id}/rotate-secret | Rotar secret |
webhook-endpoints test | POST /v1/webhook-endpoints/{id}/test | Disparar evento de prueba |
webhook-endpoints deliveries retry | POST /v1/webhook-endpoints/{id}/deliveries/{deliveryId}/retry | Reenviar entrega |
webhook-endpoints deliveries list | GET /v1/webhook-endpoints/{id}/deliveries | Listar entregas del endpoint |
Ejemplos
--params lleva parámetros de query, de ruta y de encabezado (id, página, filtros, X-Workspace-Id); --json lleva el cuerpo de la solicitud; --fields limita los campos que vuelven — vale la pena en todo list/get, para ahorrar contexto. Mira Flags globales para la referencia completa.
# Crear endpoint para cobros pagados y vencidos
kobana dunning webhook-endpoints create \
--json '{"url": "https://example.com/webhooks/kobana", "events": ["charge.paid", "charge.overdue"]}'
# Disparar un evento de prueba
kobana dunning webhook-endpoints test --params '{"id": "ENDPOINT_ID"}'
# Entregas fallidas
kobana dunning webhook-endpoints deliveries list --params '{"id": "ENDPOINT_ID", "status": "failed"}'
# Reenviar una entrega
kobana dunning webhook-endpoints deliveries retry --params '{"id": "ENDPOINT_ID", "deliveryId": "DELIVERY_ID"}'
# Rotar el secret
kobana dunning webhook-endpoints rotate-secret --params '{"id": "ENDPOINT_ID"}' --dry-run
Próximos pasos
- Identidad del token
- Introspección de schema — todos los parámetros que acepta este recurso.