Recuperar un webhook con fallas - Lerian

Recupera una suscripción webhook después de que tu endpoint dejó de responder.

Participantes

Tu institución. Tu sistema llama a la API de Streaming Hub con un token de Access Manager. Tu endpoint HTTPS recibe las entregas.
Streaming Hub. El servicio de plataforma de Lerian que hace reintentos de las entregas con fallas e informa la salud de cada suscripción. Lerian lo configura para tu institución.
Producto Lerian. El producto que publica el evento de negocio, por ejemplo Midaz.

Diagrama

Recuperar un webhook con fallas

Pasos

#	Origen	Destino	Mensaje	API de Lerian	Qué ocurre
1	Producto Lerian	Streaming Hub	Evento		El producto publica un evento de negocio.
2	Streaming Hub	Tu institución	Webhook	Los eventos en `event_types`	Streaming Hub envía el evento firmado a tu endpoint.
3	Tu institución	Streaming Hub	Respuesta		Tu endpoint responde con un error, o no responde a tiempo. Cualquier respuesta distinta de `2xx` es una falla.
4	Streaming Hub	Streaming Hub	Paso interno		Streaming Hub intenta de nuevo según un calendario de backoff. Después del último intento, deja de intentar ese evento.
5	Streaming Hub	Streaming Hub	Paso interno		Cuando las fallas siguen por mucho tiempo, Streaming Hub puede deshabilitar la suscripción. `enabled` pasa a `false`.
6	Streaming Hub	Tu institución	Evento	Evento `hub.destination.disabled`	Solo si otra suscripción tuya recibe este evento. El evento identifica la suscripción deshabilitada.
7	Tu institución	Streaming Hub	API de Lerian	`GET /v1/subscriptions/{id}/health`	Lee la salud de las entregas de la suscripción.
8	Streaming Hub	Tu institución	Respuesta		La respuesta muestra `enabled`, `status`, los resultados de las entregas, `dead_lettered`, `auto_disabled` y `last_failure_at`.
9	Tu institución	Tu institución	Paso interno		Corrige tu endpoint.
10	Tu institución	Streaming Hub	API de Lerian	`POST /v1/subscriptions/{id}/verify`	Pide a Streaming Hub que pruebe tu endpoint de nuevo.
11	Streaming Hub	Tu institución	Webhook	Evento `hub.subscription.verification_ping`	Streaming Hub envía un evento de prueba firmado a tu endpoint.
12	Tu institución	Streaming Hub	Respuesta		Tu endpoint responde `2xx`.
13	Streaming Hub	Tu institución	Respuesta		El verify responde `outcome` `ok`. La suscripción queda `enabled` y `active` de nuevo, y los eventos nuevos llegan a tu endpoint.
14	Streaming Hub	Tu institución	Evento	Evento `hub.destination.verified`	Solo si una suscripción tuya recibe este evento.

Cómo saber que terminó

El verify responde outcome ok. La vista de salud muestra enabled true y auto_disabled false.

El verify falla. El verify responde outcome failed con un detail, y la suscripción sigue deshabilitada. Corrige el endpoint y haz el verify de nuevo.
Llamas al ping en su lugar. Un ping prueba el endpoint, pero no habilita una suscripción deshabilitada. Usa el verify.
Eventos del período de falla. Streaming Hub no entrega los eventos que llegan mientras la suscripción está deshabilitada.

Relacionados