Sur cette page

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.

Réponse
{
  "status": "fail",
  "code": "EFORBIDDENURL",
  "message": "Destination is not allowed"
}
  • status vaut fail quand la requête est en cause (4xx), error quand le serveur ou la cible est en cause (5xx).
  • code est stable : c’est lui que votre code doit tester.
  • message est en anglais, destiné aux humains, et peut évoluer.

Causes et corrections

CodeHTTPCause probableQue faire
EINVALIDPARAMSHTTP400Cause 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.
EINVALIDURLHTTP400Cause probableL’url est mal formée ou n’est ni http ni https.Que faireEnvoyez une adresse absolue et encodez-la (encodeURIComponent).
EUNAUTHORIZEDHTTP401Cause 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.
EFORBIDDENURLHTTP403Cause 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.
EEMBEDNOTFOUNDHTTP404Cause 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.
ESELECTORNOTFOUNDHTTP404Cause 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.
ENOTHTMLHTTP422Cause 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.
ETOOLARGEHTTP422Cause 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.
ERATELIMITHTTP429Cause 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é.
EBROWSERHTTP500Cause 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.
EINTERNALHTTP500Cause 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.
EUNREACHABLEHTTP502Cause 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.
ETARGETSTATUSHTTP502Cause 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.
EBLOCKEDHTTP502Cause 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.
ECIRCUITOPENHTTP503Cause 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.
EBUSYHTTP503Cause probableTrop de rendus en attente sur l’instance.Que faireRéessayez après quelques secondes, avec un délai croissant.
ETIMEOUTHTTP504Cause 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, EBROWSER et EINTERNAL, avec un délai croissant.
  • Réessayez ERATELIMIT après le délai de l’en-tête retry-after.
  • Ne réessayez pas les autres codes 4xx : la même requête donnera la même erreur.

Raccourcis clavier

CtrlKou/
Ouvrir la recherche et les commandes
?
Afficher cette aide
←→
Passer d’un onglet à l’autre
Ctrl↵
Lancer la requête dans le bac à sable
Esc
Fermer un panneau ou un menu

Les raccourcis à une seule touche se désactivent dans les options d’accessibilité.