Saltar al contenido principal

Evento de prueba (webhook.test)

Disparado bajo demanda vía POST /api/v1/webhook-endpoints/{id}/test — no es suscribible y no aparece en el catálogo de suscripción. La entrega recorre el pipeline real (cola, firma HMAC, captura de request/response, reintento) y se envía solo al endpoint objetivo, independientemente de la lista de eventos suscritos.

Úsalo para validar el consumidor de punta a punta antes del primer evento de negocio: firma, autenticación del request, parseo del envelope y el 2xx rápido.

webhook.test

{
"event": "webhook.test",
"timestamp": "2026-07-23T12:00:00.000Z",
"organizationId": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
"data": {
"test": true,
"endpointId": "9e1f3a5b-7d2c-4e6a-8b0f-5c7e9a1d3f5b",
"url": "https://example.com/webhooks/kobana",
"triggeredAt": "2026-07-23T12:00:00.000Z"
}
}

La respuesta del disparo (202 Accepted) trae eventId y deliveryId — sigue la entrega en GET /api/v1/webhook-endpoints/{id}/deliveries o en la pantalla de entregas. Si el endpoint está inactivo, el disparo falla con 409 ENDPOINT_INACTIVE.

Checklist de qué validar de tu lado:

  • La firma t=,v1= coincide y el t está dentro de la tolerancia (Seguridad).
  • El consumidor responde 2xx en menos de 10 segundos.
  • data.test === true se maneja sin efectos secundarios en tu sistema (no crees registros de negocio a partir de él).