Retentativas e saúde do webhook

title: "8.14. Retentativas e saúde do webhook"
slug: rentals-partner-api-retentativas-e-saude-do-webhook
hidden: false

• Endpoint com falha (não-2xx, timeout, erro de conexão) é retentado com backoff por até
  24 horas a partir da primeira tentativa. Esgotado esse orçamento, a entrega fica
  EXHAUSTED.
• consecutiveFailures acumula entregas esgotadas desde o último sucesso. Ao atingir o limite
  configurado (5 por padrão), o webhook passa a SUSPENDED e para de receber novas
  entregas — os eventos continuam sendo registrados, mas nenhuma entrega nova é gerada.
• Reativam um webhook SUSPENDED e zeram o contador: PATCH /webhooks/{id} (qualquer
  atualização), um POST /webhooks/{id}/ping bem-sucedido, ou uma entrega bem-sucedida.
• Entregas já enfileiradas quando a suspensão acontece ficam DISCARDED.
• DELETE /webhooks/{id} revoga permanentemente — o registro é mantido, mas não recebe mais
  entregas.

Depois de reativar um webhook suspenso, use GET /webhooks/{id}/deliveries?status=EXHAUSTED
para descobrir o que ficou para trás durante a suspensão — essas entregas não são reenviadas
automaticamente.