Plateforme

Idempotence

Relancer une requête sans risque de doublon.

Si une requête de création échoue à cause du réseau, vous ne savez pas si elle a été traitée. Envoyez un en-tête Idempotency-Key unique par opération : relancer la même requête avec la même clé renvoie la réponse d'origine au lieu de créer une seconde transaction.

Idempotency-Key: salaire-2026-10-awa
  • Obligatoire pour les transferts, recommandé pour les paiements.
  • La réponse rejouée porte l'en-tête Idempotent-Replayed: true.
  • Réutiliser une clé avec un corps différent renvoie 422 idempotency_key_reused.
  • Si la première requête est encore en cours, l'API répond 409 request_in_progress.