Aller au contenu principal

idempotency_key_conflict

Statut HTTP : 409 · Rejouable : non — une nouvelle clé est nécessaire.

Cause​

La clé envoyée dans Idempotency-Key a déjà été utilisée, mais avec un corps de requête différent. L'API refuse de trancher entre les deux intentions.

Rejouer une requête identique avec la même clé ne produit pas cette erreur : c'est le comportement normal de l'idempotence, et la réponse d'origine vous est renvoyée. Ce code signale spécifiquement une réutilisation de clé sur un contenu qui a changé.

Réponse​

HTTP/1.1 409 Conflict
Content-Type: application/problem+json

{
  "type": "https://docs.pesia.fr/partner/errors/idempotency_key_conflict",
  "title": "Idempotency Key Conflict",
  "status": 409,
  "detail": "A different request was already sent with this Idempotency-Key.",
  "code": "idempotency_key_conflict",
  "originalRequestAt": "2026-08-14T08:41:02.117Z",
  "instance": "/partner/v1/dpae/submissions",
  "timestamp": "2026-08-14T09:12:44.318Z"
}

Extensions​

ChampTypeContenu
originalRequestAtstring (ISO 8601)Horodatage de la première requête reçue avec cette clé.

Que faire​

  • Vérifier d'où vient la clé dans votre code : une clé stockée puis réutilisée après modification du corps produit exactement cette erreur.
  • Si le contenu a volontairement changé, il s'agit d'une nouvelle opération : générer une nouvelle clé.
  • Si le contenu n'était pas censé changer, comparer votre corps courant avec celui envoyé à originalRequestAt — un champ non déterministe (horodatage local, ordre de sérialisation) suffit à déclencher le conflit.

Voir aussi : Idempotence · Tous les codes d'erreur