Aller au contenu principal

Clé d’idempotence réutilisée

typehttps://docs.frem.sh/reference/api/errors/idempotency-key-reused
Statut HTTP409 Conflict

Ce que cela signifie

La Idempotency-Key que vous avez envoyée a déjà été utilisée pour une requête avec un autre corps. Une clé identifie une requête logique : une nouvelle tentative avec la même clé et le même corps rejoue la première réponse, et la même clé avec un autre corps est refusée plutôt que de recevoir en silence le résultat précédent.

Exemples de messages detail renvoyés avec cette erreur :

  • This Idempotency-Key was already used with a different body. Use a new key for a different request.

Que faire

Envoyez une nouvelle clé pour une nouvelle requête. Ne réutilisez une clé que pour renvoyer exactement la même requête après une panne réseau.

Forme de la réponse

Toutes les erreurs de l’API fremforge sont au format problem+json de la RFC 9457 :

{
  "type": "https://docs.frem.sh/reference/api/errors/idempotency-key-reused",
  "title": "Conflict",
  "status": 409,
  "detail": "..."
}

Basez votre logique sur type, et non sur title ou detail : ces champs sont destinés à être lus par un humain et peuvent être reformulés.