Codes d'erreur
Toutes les erreurs renvoient du JSON avec un message en français
Format d'une erreur
{
"success": false,
"error": "Message lisible",
"conversion_id": "cm…", // si la conversion a été enregistrée
"details": { "zoom": ["…"] } // 400 « Paramètres invalides » uniquement
}Le conversion_id correspond à l'ID affiché dans vos Logs : communiquez-le au support pour un diagnostic rapide.
Liste des codes
| Code | Signification | Que faire |
|---|---|---|
| 400 | JSON invalide, paramètre manquant ou mal formé (format, margin, zoom), URL privée ou introuvable. | Corrigez la requête : le message indique le champ en cause. |
| 401 | Clé API absente, inconnue ou désactivée. | Vérifiez le header X-API-Key. |
| 402 | Quota mensuel atteint. | Passez en sandbox, attendez le 1er du mois ou changez de plan. |
| 413 | Le PDF généré dépasse la taille maximale. | Allégez la page (images) ou découpez le document. |
| 422 | La page source a répondu par une erreur HTTP (404, 500…). | Ouvrez l'URL en navigation privée : elle doit s'afficher sans connexion. |
| 500 | Erreur interne inattendue. | Réessayez ; si elle persiste, contactez le support avec le conversion_id. |
| 502 | Le moteur PDF a renvoyé une erreur. | Réessayez plus tard. |
| 503 | Moteur PDF momentanément injoignable. | Réessayez après quelques secondes. |
| 504 | Délai de conversion dépassé. | Allégez la page source ou réessayez. |
Seules les conversions réussies consomment un crédit : une requête en erreur ne vous est jamais décomptée.
