Codes d’erreur
Toute erreur a la même forme JSON, y compris sur les points d’accès qui renvoient une image ou un PDF.
{
"status": "fail",
"code": "EFORBIDDENURL",
"message": "Destination is not allowed"
}
statusvautfailquand la requête est en cause (4xx),errorquand le serveur ou la cible est en cause (5xx).codeest stable : c’est lui que votre code doit tester.messageest en anglais, destiné aux humains, et peut évoluer.
Causes et corrections
| Code | HTTP | Cause probable | Que faire |
|---|---|---|---|
EINVALIDPARAMS | HTTP400 | Cause probableUn paramètre est manquant ou a une valeur invalide. | Que faireComparez la requête à la référence ; le message nomme le paramètre. |
EINVALIDURL | HTTP400 | Cause probableL’url est mal formée ou n’est ni http ni https. | Que faireEnvoyez une adresse absolue et encodez-la (encodeURIComponent). |
EUNAUTHORIZED | HTTP401 | Cause probableLa clé envoyée dans x-api-key n’est pas connue de l’instance. | Que faireCorrigez la clé, ou retirez l’en-tête pour un appel anonyme. |
EFORBIDDENURL | HTTP403 | Cause probableLa destination est privée, locale ou interne, ou son port n’est pas autorisé. | Que faireSeules les pages publiques sont lisibles. Pour un intranet, hébergez votre instance dans ce réseau. |
EEMBEDNOTFOUND | HTTP404 | Cause probableLe chemin demandé avec embed n’existe pas pour cette page, ou vaut null. | Que faireAppelez /meta sans embed pour voir les champs disponibles ; prévoyez une image de repli. |
ESELECTORNOTFOUND | HTTP404 | Cause probableLe selector ne correspond à aucun élément visible. | Que faireVérifiez le sélecteur dans le navigateur ; ajoutez waitForSelector si l’élément arrive tard. |
ENOTHTML | HTTP422 | Cause probableLa cible est une image, un PDF ou un autre fichier, pas une page HTML. | Que faireUtilisez ce point d’accès sur une page ; /screenshot accepte les autres types. |
ETOOLARGE | HTTP422 | Cause probableLe PDF ou le résultat généré dépasse la taille maximale. | Que faireRéduisez la page : désactivez printBackground, ou ciblez une page plus courte. |
ERATELIMIT | HTTP429 | Cause probableTrop de requêtes dans la fenêtre en cours. | Que faireAttendez le délai de retry-after. Mettez vos résultats en cache, ou utilisez une clé. |
EBROWSER | HTTP500 | Cause probableChromium a planté ou n’a pas pu démarrer. | Que faireRéessayez. Si l’erreur persiste sur votre instance, vérifiez l’installation de Chromium. |
EINTERNAL | HTTP500 | Cause probableErreur inattendue du serveur. | Que faireRéessayez ; si elle se répète, ouvrez un ticket avec l’en-tête x-request-id de la réponse. |
EUNREACHABLE | HTTP502 | Cause probableLe site cible ne répond pas : nom introuvable, connexion refusée, erreur TLS. | Que faireVérifiez l’adresse dans un navigateur. Le site peut être en panne ou bloquer les robots. |
ETARGETSTATUS | HTTP502 | Cause probableLe site cible a répondu par une erreur HTTP (404, 403, 500…). | Que faireLe message donne le statut. Vérifiez que la page existe et qu’elle est publique. |
EBLOCKED | HTTP502 | Cause probableLe site a servi une page de blocage anti-robot au lieu de son contenu. | Que faireOmnillink ne contourne pas ces protections. Vérifiez la page dans un navigateur, ou demandez un accès au site. |
ECIRCUITOPEN | HTTP503 | Cause probableLe site cible a échoué plusieurs fois de suite ; il est mis à l’écart quelques secondes. | Que faireRéessayez après le délai de l’en-tête retry-after. |
EBUSY | HTTP503 | Cause probableTrop de rendus en attente sur l’instance. | Que faireRéessayez après quelques secondes, avec un délai croissant. |
ETIMEOUT | HTTP504 | Cause probableLe site cible n’a pas répondu à temps. | Que faireRéessayez. Pour une page lente, render=never évite le navigateur. |
Quand réessayer
- Réessayez
EBUSY,ECIRCUITOPEN,ETIMEOUT,EUNREACHABLE,EBROWSERetEINTERNAL, avec un délai croissant. - Réessayez
ERATELIMITaprès le délai de l’en-têteretry-after. - Ne réessayez pas les autres codes 4xx : la même requête donnera la même erreur.