​

Comportamento de entrega

A Rewrite considera a entrega bem-sucedida quando seu endpoint retorna qualquer resposta 2xx. Retries acontecem quando o endpoint:

• retorna status diferente de 2xx
• da timeout
• falha na camada de rede

O timeout atual da request de webhook e 5 segundos.

​

Agenda de retry

O backend usa hoje 5 tentativas no total: Depois da ultima tentativa, a entrega falha em definitivo.

​

Quando o retry para

As retentativas param quando:

• seu endpoint retorna 2xx
• a quinta tentativa falha
• o webhook e removido ou desativado antes da proxima entrega

​

Expectativa de idempotencia

A entrega de webhook e at-least-once. Seu handler deve:

• armazenar ids de evento processados
• ignorar duplicados com seguranca
• tornar as escritas downstream idempotentes

​

Logs de entrega

Use:

• GET /webhooks/{id}/deliveries para listar tentativas de um webhook especifico
• GET /deliveries para navegar entregas de webhook em nivel de projeto
• GET /logs/{id} para inspecionar um log especifico por id

A retencao atual depende do plano do projeto:

• Starter/default: 3 dias
• Pro: 14 dias
• Business: 16 dias
• Enterprise: 1 mes