Idempotence

Envoyez un en-tête Idempotency-Key avec une valeur unique par opération sur les POST qui facturent ou réservent des crédits.

Un nouvel essai réseau avec la même clé renvoie le résultat d'origine au lieu de ré-exécuter (et de re-facturer ou re-réserver).

Règles

• Obligatoire sur POST /v1/batches (qui réserve des crédits) : 428 s'il manque.
• Recommandé sur POST /v1/generations.
• Réutiliser une clé avec une autre charge utile renvoie 422 (on ne vous remet pas le résultat d'une autre opération) ; la réutiliser sur un autre endpoint aussi. Utilisez une clé distincte par opération.
• POST /v1/products (upsert) accepte l'en-tête, mais l'upsert est déjà idempotent par SKU. Ne réutilisez pas la même clé avec un lot différent : elle renverrait les compteurs en cache du premier sans écrire le nouveau.
• Une opération encore en cours avec cette clé renvoie 409 : réessayez dans un instant.