Recuperar um webhook com falha - Lerian

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

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`	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`	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