Aller au contenu
KelkiDéveloppeurs

Idempotence

Une coupure réseau ne doit jamais créer deux demandes ni envoyer deux e-mails. Renvoyez la même requête avec le même Idempotency-Key : vous recevez la même réponse.

Où l'en-tête est obligatoire

Idempotency-Key (8 à 64 caractères, unique par opération) est exigé sur :

Les lectures et POST /trade-matches (lecture seule) n'en ont pas besoin.

Rejeu

SituationRéponse
Même clé, même corps, sous 24 heuresla réponse d'origine, avec Idempotent-Replayed: true
Même clé, corps différent422 idempotency_key_reused
Même clé, requête d'origine encore en cours409 idempotency_in_progress : réessayez après quelques secondes

La clé est rattachée à votre compte et au mode (test ou live) : deux partenaires ne peuvent pas se gêner.

Choisir ses clés

Dérivez la clé de votre propre identifiant d'opération : resa-0042-draft-1 pour le brouillon de la réservation 0042, resa-0042-confirmation-1 pour sa confirmation. Pour recommencer volontairement une opération, changez le suffixe.

Doublons de contenu

Indépendamment de l'en-tête, une demande identique déjà en attente pour la même personne n'est pas recréée et ne déclenche aucun nouvel e-mail (duplicate_request, erreurs).