Réponse rapide
Comment savoir si WebReaderAPI fonctionne ?
Appelez GET https://webreaderapi.com/api/v1/credits avec votre clé : c'est gratuit, et une réponse normale signifie que l'API et votre clé fonctionnent. Si une page échoue, le code d'erreur vous indique pourquoi, et WebReaderAPI ne facture rien pour cela. Les incidents de notre côté sont consignés sur le changelog avec leur date.
Quel est le health check le plus rapide ?
L'endpoint de crédits. Il répond sans récupérer aucun site web, donc il ne teste que notre côté : l'authentification, l'API et votre compte.
curl -s https://webreaderapi.com/api/v1/credits -H "Authorization: Bearer $WEBREADER_API_KEY"
Quelles erreurs viennent du site web, et lesquelles viennent de nous ?
Le code d'erreur indique où se situe le problème. Aucune de ces erreurs n'utilise de crédit.
| Code | Où se situe le problème | Que faire |
|---|---|---|
blocked_by_robots | Le robots.txt du site refuse notre crawler | Rien : le site a dit non |
blocked_by_site_policy | Le site déclare ai-input=no | Rien : le site a dit non |
target_refused | Le site a répondu 403, 429, un challenge ou un login | Réessayez plus tard, ou demandez l'accès au site |
fetch_failed | DNS, TLS, connexion, ou une page 404/410 | Vérifiez l'URL ; réessayez plus tard |
fetch_timeout | Le site n'a pas répondu à temps | Réessayez avec un timeout plus long |
concurrency_limit | Trop de requêtes simultanées depuis votre compte | Ralentissez ou demandez une limite plus élevée |
invalid_api_key, insufficient_credits | Votre clé ou votre solde | Vérifiez le dashboard |
La page des erreurs détaille chaque cas, avec une boucle de retry.
Pourquoi n'y a-t-il pas de chiffre de disponibilité en direct ici ?
Parce que nous n'en avons pas encore mesuré sur un échantillon public, et un chiffre inventé vous induirait en erreur. Le succès d'une lecture dépend surtout du site lu, donc un simple pourcentage dirait peu de choses. Une fois que nous publierons des chiffres, ils viendront avec la méthode, l'échantillon et la date.
Où les incidents sont-ils annoncés ?
Sur le changelog, avec la date, les endpoints concernés et ce qui a été fait. Si vous voyez des erreurs répétées de notre côté (des codes autres que ceux causés par le site cible), écrivez à [email protected] avec l'heure de la requête et le code d'erreur.
Statut : questions fréquentes
Vérifier mes crédits coûte-t-il quelque chose ?
Non. GET https://webreaderapi.com/api/v1/credits n'utilise jamais de crédit, donc vous pouvez l'appeler depuis un health check aussi souvent que vous voulez, dans la limite de votre concurrence.
Une page échoue chez moi mais s'ouvre dans mon navigateur. Pourquoi ?
Généralement parce que le site traite les robots différemment des humains : il peut refuser notre crawler dans robots.txt ou répondre aux requêtes automatisées par une page de challenge. Nous renvoyons sa réponse et ne facturons rien. Le code d'erreur et target_status montrent ce que le site a envoyé.
Les lectures en échec sont-elles facturées ?
Non. 1 crédit = 1 page lue sans navigateur ; 2 crédits quand la page nécessite un navigateur pour exécuter JavaScript. Une requête qui échoue, ou qu'un robots.txt de site refuse, n'est pas facturée.