Mise à jour de l'API unifiée : Gestion améliorée de l'idempotence
Au cœur de toute intégration API robuste se trouve l’idempotence — un mécanisme qui garantit que la répétition d’une requête ne produit pas d’effets secondaires non souhaités.
Pour offrir une meilleure visibilité sur la façon dont vos requêtes sont traitées, nous avons introduit une amélioration discrète mais impactante à nos en-têtes de réponse.
Cette mise à jour s’applique à tous les services propulsés par l’API unifiée — actuellement SIGN IT, SIGN FR et E-INVOICE.
Le défi : « S’agissait-il d’une réponse rejouée ? »
Section intitulée « Le défi : « S’agissait-il d’une réponse rejouée ? » »Lorsqu’une requête est retentée avec le même X-Idempotency-Key, notre API renvoie correctement la réponse mise en cache de l’opération originale. Ce comportement empêche les traitements en double et est fondamental pour des intégrations fiables.
Cependant, cela peut rendre le débogage plus difficile. Dans certaines situations — notamment lors de l’investigation de cas limites — il peut ne pas être immédiatement évident si une réponse a été générée à nouveau ou servie depuis le cache d’idempotence.
La solution : X-Idempotency-Replayed
Section intitulée « La solution : X-Idempotency-Replayed »Avec la dernière version de l’API unifiée du 18 mars 2026, toutes les réponses POST et PATCH incluent désormais un nouvel en-tête : X-Idempotency-Replayed.
Cet en-tête indique explicitement si une réponse a été rejouée depuis le cache d’idempotence :
X-Idempotency-Replayed: "true"
La requête a été identifiée comme une nouvelle tentative et la réponse a été renvoyée depuis le cache.
X-Idempotency-Replayed: "false"
La requête a été traitée comme une nouvelle opération et la réponse a été générée normalement.
Grâce à cette mise à jour, le comportement d’idempotence devient plus transparent — réduisant le temps de débogage et vous aidant à construire des intégrations plus fiables.
Was this page helpful?