> ## 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 um webhook com falha

> O que o Streaming Hub faz quando seu endpoint de webhook para de responder, e como você lê a saúde das entregas e retoma a entrega.

Traga de volta uma subscription webhook depois que seu endpoint parou de responder.

## Participantes

***

* **Sua instituição.** Seu sistema chama a API do Streaming Hub com um token do Access Manager. Seu endpoint HTTPS recebe as entregas.
* **Streaming Hub.** O serviço de plataforma da Lerian que faz novas tentativas das entregas com falha e informa a saúde de cada subscription. A Lerian o configura para sua instituição.
* **Produto Lerian.** O produto que publica o evento de negócio, por exemplo o Midaz.

## Diagrama

***

![Recuperar um webhook com falha](https://mintcdn.com/lerian-49cb71fc/WuRfbo_y9uSbzyyX/images/pt/d2/id-recover-a-failing-webhook.svg?fit=max\&auto=format\&n=WuRfbo_y9uSbzyyX\&q=85\&s=db277d3fbfb9b7962dd4a6a65475dafb)

## Passo a passo

***

| # | Origem | Destino | Mensagem | API da Lerian | O que acontece |
| - | - | - | - | - | - |
| 1 | Produto Lerian | Streaming Hub | Evento | | O produto publica um evento de negócio. |
| 2 | Streaming Hub | Sua instituição | Webhook | Os eventos em `event_types` | O Streaming Hub envia o evento assinado ao seu endpoint. |
| 3 | Sua instituição | Streaming Hub | Resposta | | Seu endpoint responde com um erro, ou não responde a tempo. Qualquer resposta diferente de `2xx` é uma falha. |
| 4 | Streaming Hub | Streaming Hub | Etapa interna | | O Streaming Hub tenta de novo em um calendário de backoff. Depois da última tentativa, ele para de tentar aquele evento. |
| 5 | Streaming Hub | Streaming Hub | Etapa interna | | Quando as falhas continuam por muito tempo, o Streaming Hub pode desabilitar a subscription. `enabled` passa a ser `false`. |
| 6 | Streaming Hub | Sua instituição | Evento | Evento `hub.destination.disabled` | Apenas se outra subscription sua recebe este evento. O evento identifica a subscription desabilitada. |
| 7 | Sua instituição | Streaming Hub | API da Lerian | [`GET /v1/subscriptions/{id}/health`](https://docs.lerian.studio/pt/reference/platform/streaming-hub/get-subscription-health) | Leia a saúde das entregas da subscription. |
| 8 | Streaming Hub | Sua instituição | Resposta | | A resposta mostra `enabled`, `status`, os resultados das entregas, `dead_lettered`, `auto_disabled` e `last_failure_at`. |
| 9 | Sua instituição | Sua instituição | Etapa interna | | Corrija seu endpoint. |
| 10 | Sua instituição | Streaming Hub | API da Lerian | [`POST /v1/subscriptions/{id}/verify`](https://docs.lerian.studio/pt/reference/platform/streaming-hub/verify-subscription) | Peça ao Streaming Hub que teste seu endpoint de novo. |
| 11 | Streaming Hub | Sua instituição | Webhook | Evento `hub.subscription.verification_ping` | O Streaming Hub envia um evento de teste assinado ao seu endpoint. |
| 12 | Sua instituição | Streaming Hub | Resposta | | Seu endpoint responde `2xx`. |
| 13 | Streaming Hub | Sua instituição | Resposta | | O verify responde `outcome` `ok`. A subscription fica `enabled` e `active` de novo, e novos eventos chegam ao seu endpoint. |
| 14 | Streaming Hub | Sua instituição | Evento | Evento `hub.destination.verified` | Apenas se uma subscription sua recebe este evento. |

## Como saber que terminou

***

O verify responde `outcome` `ok`. A visão de saúde mostra `enabled` `true` e `auto_disabled` `false`.

* **O verify falha.** O verify responde `outcome` `failed` com um `detail`, e a subscription continua desabilitada. Corrija o endpoint e faça o verify de novo.
* **Você chama o ping no lugar.** Um ping testa o endpoint, mas não habilita uma subscription desabilitada. Use o verify.
* **Eventos do período de falha.** O Streaming Hub não entrega os eventos que chegam enquanto a subscription está desabilitada.

## Relacionados

***

* [Receber eventos em um webhook](https://docs.lerian.studio/pt/diagrams/platform-services/receive-events-on-a-webhook.md)
* [Como o Streaming Hub funciona](https://docs.lerian.studio/pt/platform/streaming-hub/how-streaming-hub-works.md)
* [Gerenciar subscriptions](https://docs.lerian.studio/pt/platform/streaming-hub/managing-subscriptions.md)


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