Aller au contenu principal

idempotency_key_required

Statut HTTP : 400 · Rejouable : non — la requête doit être corrigée.

Cause​

Toute requête mutante de l'API partenaire (POST, PATCH, DELETE) exige un header Idempotency-Key. Il protège vos envois d'un double traitement en cas de timeout réseau ou de rejeu. Votre requête n'en portait pas.

Réponse​

HTTP/1.1 400 Bad Request
Content-Type: application/problem+json

{
  "type": "https://docs.pesia.fr/partner/errors/idempotency_key_required",
  "title": "Idempotency Key Required",
  "status": 400,
  "detail": "Idempotency-Key header is required for mutating requests.",
  "code": "idempotency_key_required",
  "instance": "/partner/v1/dpae/submissions",
  "timestamp": "2026-08-14T09:12:44.318Z"
}

Extensions​

Aucune — seuls les champs standard ci-dessus.

Que faire​

  • Ajouter le header sur toutes vos requêtes mutantes, avec un UUIDv4 ou un ULID :

    curl -X POST https://api.pesia.fr/partner/v1/dpae/submissions \
      -H "Authorization: Bearer $TOKEN" \
      -H "Idempotency-Key: $(uuidgen)" \
      -H "Content-Type: application/json" \
      -d @submission.json

  • Générer la clé avant le premier envoi et la conserver : un rejeu après timeout doit réutiliser la même clé, sinon l'opération est traitée deux fois.

Voir aussi : Idempotence · Tous les codes d'erreur