Kurze Antwort
Woran erkenne ich, ob WebReaderAPI funktioniert?
Rufen Sie GET https://webreaderapi.com/api/v1/credits mit Ihrem Schlüssel auf: Das ist kostenlos, und eine normale Antwort bedeutet, dass die API und Ihr Schlüssel funktionieren. Wenn eine Seite fehlschlägt, sagt Ihnen der Fehlercode, warum, und WebReaderAPI berechnet dafür nichts. Störungen auf unserer Seite werden mit Datum im Changelog festgehalten.
Was ist der schnellste Health-Check?
Der Credits-Endpoint. Er antwortet, ohne eine Website abzurufen, und testet daher nur unsere Seite: Authentifizierung, die API und Ihr Konto.
curl -s https://webreaderapi.com/api/v1/credits -H "Authorization: Bearer $WEBREADER_API_KEY"
Welche Fehler kommen von der Website und welche von uns?
Der Fehlercode sagt, wo das Problem liegt. Keiner dieser Fehler verbraucht einen Credit.
| Code | Wo das Problem liegt | Was zu tun ist |
|---|---|---|
blocked_by_robots | Die robots.txt der Website lehnt unseren Crawler ab | Nichts: Die Website hat Nein gesagt |
blocked_by_site_policy | Die Website erklärt ai-input=no | Nichts: Die Website hat Nein gesagt |
target_refused | Die Website antwortete mit 403, 429, einer Challenge oder einem Login | Später erneut versuchen oder die Website um Zugang bitten |
fetch_failed | DNS, TLS, Verbindung oder eine 404/410-Seite | URL prüfen; später erneut versuchen |
fetch_timeout | Die Website antwortete nicht rechtzeitig | Erneut versuchen mit einem längeren timeout |
concurrency_limit | Zu viele Anfragen gleichzeitig von Ihrem Konto | Drosseln oder ein höheres Limit anfragen |
invalid_api_key, insufficient_credits | Ihr Schlüssel oder Ihr Guthaben | Dashboard prüfen |
Die Fehlerseite beschreibt jeden Fall im Detail, mit einer Retry-Schleife.
Warum steht hier keine Live-Uptime-Zahl?
Weil wir noch keine über eine öffentliche Stichprobe gemessen haben und eine erfundene Zahl Sie irreführen würde. Der Erfolg eines Reads hängt größtenteils von der gelesenen Website ab, daher würde eine einzelne Prozentzahl wenig aussagen. Sobald wir Zahlen veröffentlichen, kommen sie mit Methode, Stichprobe und Datum.
Wo werden Störungen angekündigt?
Im Changelog, mit Datum, den betroffenen Endpoints und dem, was unternommen wurde. Wenn Sie wiederholte Fehler auf unserer Seite sehen (Codes, die nicht durch die Ziel-Website verursacht werden), schreiben Sie an [email protected] mit der Anfragezeit und dem Fehlercode.
Status: häufige Fragen
Kostet es etwas, meine Credits zu prüfen?
Nein. GET https://webreaderapi.com/api/v1/credits verbraucht nie einen Credit, Sie können ihn also im Rahmen Ihres Concurrency-Limits beliebig oft im Health-Check aufrufen.
Eine Seite schlägt bei mir fehl, öffnet sich aber in meinem Browser. Warum?
Meist weil die Website robots anders behandelt als Menschen: Sie kann unseren Crawler in robots.txt ablehnen oder automatisierte Anfragen mit einer Challenge-Seite beantworten. Wir geben ihre Antwort zurück und berechnen nichts. Der Fehlercode und target_status zeigen, was die Website gesendet hat.
Werden fehlgeschlagene Reads jemals berechnet?
Nein. 1 Credit = 1 gelesene Seite ohne Browser; 2 Credits, wenn die Seite einen Browser braucht, um JavaScript auszuführen. Eine Suchanfrage, die fehlschlägt oder die eine robots.txt einer Website verweigert, wird nicht abgerechnet.