Retries e Backoff
Estratégia de retentativa com backoff exponencial. Até 5 tentativas com jitter. Retry manual via painel.
Política de retentativa
Se o seu endpoint não responder com 2xx (ou não responder a tempo), o Minha CNH
re-tenta a entrega com backoff exponencial e jitter, até 5 tentativas:
| Tentativa | Delay aproximado até a próxima |
|---|---|
| 1ª | imediata |
| 2ª | ~30 segundos |
| 3ª | ~1 minuto |
| 4ª | ~2 minutos |
| 5ª | ~4 minutos |
Cada delay tem jitter de ±20%. Após a 5ª tentativa sem sucesso, a entrega é marcada como FAILED.
Relatório ainda disponível
Uma entrega FAILED não altera o status do relatório, que continua DELIVERED e
acessível via GET /api/v1/reports/{reportId}. Apenas o canal webhook falhou.
URL snapshotada
A URL de destino é capturada no momento do enfileiramento. Alterar a URL do webhook nas configurações não redireciona entregas já enfileiradas: elas continuam a ser enviadas para a URL original.
Retry manual
No painel de Configurações → API, na secção Logs de Entrega, cada entrega com status FAILED
tem um botão Tentar novamente que a re-enfileira imediatamente (com uma tentativa extra).
Verificação de logs
O log de entrega mostra, por entrega:
- Status (
PENDING,DELIVERING,DELIVERED,FAILED) - Número de tentativas (
attempts/maxAttempts) - Código de resposta HTTP recebido na última tentativa
- Último erro registrado, quando houver
Assinatura recomputada por tentativa
A assinatura t=<unix>,v1=<hex> é recalculada a cada tentativa de entrega, porque o t
entra no HMAC e a janela anti-replay é de ±5 minutos. Verifique sempre contra o header recebido,
não contra um valor armazenado.