> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Recuperar un webhook con fallas

> Qué hace Streaming Hub cuando tu endpoint de webhook deja de responder, y cómo lees la salud de las entregas y reanudas la entrega.

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](https://mintcdn.com/lerian-49cb71fc/MbifquGny5fsdtVy/images/es/d2/id-recover-a-failing-webhook.svg?fit=max\&auto=format\&n=MbifquGny5fsdtVy\&q=85\&s=aa2e81c17ba3faaa3222d06bfc9338c2)

## 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`](https://docs.lerian.studio/es/reference/platform/streaming-hub/get-subscription-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`](https://docs.lerian.studio/es/reference/platform/streaming-hub/verify-subscription) | 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

***

* [Recibir eventos en un webhook](https://docs.lerian.studio/es/diagrams/platform-services/receive-events-on-a-webhook.md)
* [Cómo funciona Streaming Hub](https://docs.lerian.studio/es/platform/streaming-hub/how-streaming-hub-works.md)
* [Gestión de suscripciones](https://docs.lerian.studio/es/platform/streaming-hub/managing-subscriptions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.