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 :
POST /requests,PATCH /requests/{request_id},DELETE /requests/{request_id},POST /requests/{request_id}/confirmation;POST /agent/conversationsetPOST /agent/conversations/{conversation_id}/messages;POST /webhook-endpoints.
Les lectures et POST /trade-matches (lecture seule) n'en ont pas besoin.
Rejeu
| Situation | Réponse |
|---|---|
| Même clé, même corps, sous 24 heures | la réponse d'origine, avec Idempotent-Replayed: true |
| Même clé, corps différent | 422 idempotency_key_reused |
| Même clé, requête d'origine encore en cours | 409 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).