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.