ConverterHQDevelopers
API v1

Idempotenza e retry

Ripeti in sicurezza senza duplicare calcolo costoso o effetti collaterali.

Un errore di rete è ambiguo: ConverterHQ può aver accettato la richiesta anche se il client non riceve la risposta. Create e handler devono essere replay-safe.

Creazioni idempotenti

Usa la stessa Idempotency-Key solo per la stessa operazione logica e client_reference_id per il tuo ID di business. Non riutilizzare la key con un body diverso.

Retry di trasporto

Riprova timeout, reset, 429 e 5xx retryable con backoff esponenziale e jitter. Rispetta Retry-After; non ritentare automaticamente 4xx deterministici.

Retry delle Tasks

Un retry di esecuzione crea una nuova attempt e conserva il fallimento precedente. Le Tasks upstream già riuscite non vengono cancellate se va ripetuto solo un ramo downstream.

Idempotenza webhook

Verifica la firma prima degli effetti e deduplica tramite event_id. Rispondi rapidamente e sposta il lavoro lento nella tua coda.