ConverterHQDevelopers
API v1

Idempotência e repetição

Repita com segurança sem duplicar processamento caro nem efeitos colaterais.

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.