idempotency_key_invalid_format

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

Cause

Le header Idempotency-Key était présent mais sa valeur n'est pas un identifiant accepté. Seuls deux formats le sont : UUIDv4 et ULID. Ce verrou existe pour garantir une entropie suffisante — une clé devinable ou séquentielle exposerait vos envois à des collisions entre requêtes sans rapport.

Réponse

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

{
  "type": "https://docs.pesia.fr/partner/errors/idempotency_key_invalid_format",
  "title": "Idempotency Key Invalid Format",
  "status": 400,
  "detail": "Idempotency-Key must be a UUIDv4 or ULID. Received: batch-2026-08-14",
  "code": "idempotency_key_invalid_format",
  "instance": "/partner/v1/payroll-batches",
  "timestamp": "2026-08-14T09:12:44.318Z"
}

Le detail reprend la valeur reçue, tronquée à 64 caractères.

Extensions

Aucune — seuls les champs standard ci-dessus.

Que faire

• Générer la clé avec la primitive de votre langage plutôt qu'à la main. En ligne de commande : uuidgen.
• Ne pas dériver la clé d'un identifiant métier lisible (numéro de lot, date, code d'agence) : ces valeurs se répètent entre requêtes différentes.
• Une clé par opération logique, conservée pour les rejeux.

Voir aussi : Idempotence · Tous les codes d'erreur