Codes d'erreur et diagnostic

Structure standardisée des erreurs HTTP, catalogue des codes et recommandations.

Lorsqu'une requête ne peut aboutir, SmallPict renvoie un code de statut HTTP standard accompagné d'une charge JSON détaillée.

Enveloppe d'erreur JSON

JSON

{  "success": false,  "error": {    "code": "INVALID_IMAGE_PAYLOAD",    "message": "Le fichier transmis n'est pas une image valide ou est altéré.",    "details": {      "mime_type": "text/html",      "expected": [        "image/jpeg",        "image/png",        "image/webp",        "image/avif"      ]    }  }}

Répertoire des erreurs HTTP

Code	Identifiant	Cause	Résolution
`400`	`BAD_REQUEST`	Corps JSON mal formé ou paramètres invalides.	Vérifiez la syntaxe JSON et les clés envoyées.
`401`	`UNAUTHORIZED`	Clé d'API absente ou révoquée.	Vérifiez l'en-tête `X-API-Key`.
`401`	`TIMESTAMP_DRIFT`	Horodatage décalé de plus de ±300 secondes.	Synchronisez l'horloge de votre serveur via NTP.
`401`	`INVALID_SIGNATURE`	Signature HMAC-SHA256 incorrecte.	Vérifiez le calcul de la chaîne canonique et la clé secrète.
`403`	`FORBIDDEN`	Privilèges insuffisants pour l'action demandée.	Ajustez les périmètres de la clé dans la console.
`404`	`NOT_FOUND`	La tâche (`job_id`) ou ressource demandée n'existe pas.	Vérifiez l'identifiant transmis dans l'URL.
`413`	`PAYLOAD_TOO_LARGE`	Fichier excédant la taille maximale autorisée par votre offre.	Compressez ou redimensionnez l'image au préalable.
`415`	`UNSUPPORTED_MEDIA`	Format d'image non pris en charge.	Transmettez du JPEG, PNG, WebP, AVIF ou SVG.
`422`	`UNPROCESSABLE`	En-tête valide mais données binaires corrompues.	Assurez-vous que le téléversement n'est pas tronqué.
`429`	`RATE_LIMIT_EXCEEDED`	Trop de requêtes par seconde.	Utilisez une logique d'attente avec Exponential Backoff.
`429`	`QUOTA_EXCEEDED`	Le quota mensuel de transformations est épuisé.	Faites évoluer votre forfait dans le tableau de bord.
`500`	`INTERNAL_ERROR`	Défaillance imprévue côté serveur.	Réessayez après un court intervalle.
`503`	`SERVICE_UNAVAILABLE`	Maintenance en cours ou surcharge momentanée.	Rejouez l'appel en mode passthrough.