Falhas de rede são ambíguas: ConverterHQ pode aceitar a requisição sem o cliente receber a resposta. Criações e handlers precisam ser seguros para replay.
Criações idempotentes
Use a mesma Idempotency-Key apenas para a mesma operação lógica e client_reference_id para seu ID de negócio. Nunca reutilize a chave com corpo diferente.
Retries de transporte
Repita timeouts, resets, 429 e 5xx retryable com backoff exponencial e jitter. Respeite Retry-After e não repita 4xx determinísticos automaticamente.
Retries de Tasks
Um retry cria uma nova attempt e preserva a falha anterior. Tasks upstream já concluídas não são apagadas quando apenas uma ramificação precisa rodar de novo.
Idempotência de webhooks
Verifique assinatura antes do efeito e deduplique por event_id. Responda rápido e mova trabalho lento para sua própria fila.