Une coupure réseau est ambiguë: ConverterHQ peut avoir accepté la requête sans que votre client reçoive la réponse. Concevez donc les créations et handlers pour le rejeu.
Créations idempotentes
Envoyez une Idempotency-Key stable pour la même opération logique et un client_reference_id pour votre identifiant métier. Ne réutilisez jamais une même clé avec un corps différent.
Nouvelles tentatives réseau
Réessayez timeouts, resets, 429 et erreurs 5xx retryable avec backoff exponentiel et jitter. Respectez Retry-After et ne rejouez pas automatiquement les erreurs 4xx déterministes.
Retries de Tasks
Un retry d’exécution crée une nouvelle attempt et conserve l’échec précédent. Les Tasks amont déjà réussies ne sont pas effacées si seule une branche aval doit être rejouée.
Idempotence des webhooks
Vérifiez la signature avant tout effet, puis dédupliquez par event_id. Répondez vite et placez vos traitements lents dans votre propre file.