Réessayer un appel API avec une clé d’idempotence
Utilisez un identifiant stable par événement source, par exemple crm-contact-584-inscription-12. Une nouvelle tentative conserve le même corps et la même clé. Une coupure réseau ou un délai dépassé ne signifie pas que l’écriture a échoué. Pendant sept jours, une clé déjà validée renvoie les mêmes identifiants et le statut HTTP d’origine sans répéter l’opération ; Idempotency-Replayed: true l’indique. Le request_id reste propre à chaque tentative.
La clé est propre à l’intégration, même après rotation des jetons. La réutiliser avec une autre route ou un contenu différent renvoie 409 IDEMPOTENCY_CONFLICT. Les clés des objets JSON sont ordonnées pour la comparaison ; les tableaux gardent leur ordre et les décimaux/defaults sont normalisés. Une clé expirée peut produire une nouvelle opération. Les permissions et quotas actuels sont vérifiés avant tout résultat mémorisé. Les erreurs sans validation complète de l’opération ne sont pas enregistrées comme un succès.
Réessayez les erreurs temporaires avec attente exponentielle et variation aléatoire ; respectez Retry-After. Une erreur 409 REQUEST_IN_PROGRESS autorise un nouvel essai identique après le délai. Ne réessayez pas automatiquement les autres conflits d’identité/contrat ni les erreurs de validation sans les corriger. Pour une très longue attente de quota, planifiez la nouvelle tentative au lieu de bloquer votre processus.