IDEMPOTENCY-KEY-EDI

Pattern HTTP de prévention des doublons appliqué aux API EDI.

Définition

Le header Idempotency-Key (draft IETF 'The Idempotency HTTP Header Field') est généré côté client (UUID v4 typique) et inclus dans chaque POST. Le serveur stocke la clé + réponse pendant N heures. Si la même clé revient, retour de la réponse cachée plutôt que ré-exécution. Adopté par Stripe, PayPal, et les API EDI modernes (Stedi, Cleo).

Origine

Stripe popularise le pattern en 2015. IETF draft draft-ietf-httpapi-idempotency-key-header en cours d'adoption.

Exemple en contexte

POST /v1/invoices avec header Idempotency-Key: 4d1f8a3c-8f29-4e2c-8b71-9e8c8f3a3c5d → si réseau timeout, retry avec même clé → serveur retourne la réponse précédente.

Termes liés

• WebHook spec — pattern voisin.