Codes d'erreur

L'API utilise des codes HTTP standard. Voici ceux que la surface publique peut renvoyer.

Code	Signification
`401`	Clé API absente, mal formée, invalide, révoquée ou expirée.
`402`	Solde de crédits insuffisant.
`403`	La clé n'a pas le scope requis.
`404`	Ressource introuvable (ou d'un autre tenant : non distinguée).
`409`	Conflit : le SKU existe déjà · lot non annulable · opération avec cet Idempotency-Key en cours.
`413`	Le corps dépasse la limite de 2 Mo (import du catalogue et envoi d'images).
`415`	Le fichier envoyé n'est pas ce que `presign` a déclaré : sa signature binaire ne correspond pas au `mime` (ou c'est un format refusé, comme le SVG). L'objet est supprimé ; recommencez avec le bon fichier.
`422`	Charge utile invalide (y compris lot vide ou plus de 500 produits) · Idempotency-Key réutilisée avec une autre charge utile ou un autre endpoint.
`428`	Idempotency-Key obligatoire manquant (POST /v1/batches).
`429`	Limite de débit (réessayez après Retry-After) ou plafond de dépense IA quotidien (sans Retry-After).
`502`	Le fournisseur d'images a rejeté la requête (séances photo IA) : rien n'a été facturé. Vérifiez les références et réessayez.
`503`	Service en pause (maintenance, IA coupée ou API publique désactivée) : rien n'a été facturé.