Kort antwoord
Hoe weet ik of WebReaderAPI werkt?
Roep GET https://webreaderapi.com/api/v1/credits aan met je sleutel: dat is gratis, en een normaal antwoord betekent dat de API en je sleutel werken. Als een pagina mislukt, vertelt de foutcode je waarom, en WebReaderAPI rekent daar niets voor. Incidenten aan onze kant staan met hun datum op de changelog.
Wat is de snelste health check?
De credits-endpoint. Die antwoordt zonder een website op te halen, dus test alleen onze kant: authenticatie, de API en je account.
curl -s https://webreaderapi.com/api/v1/credits -H "Authorization: Bearer $WEBREADER_API_KEY"
Welke fouten komen van de website en welke van ons?
De foutcode zegt waar het probleem zit. Geen van deze fouten gebruikt een credit.
| Code | Waar het probleem zit | Wat je moet doen |
|---|---|---|
blocked_by_robots | De robots.txt van de site weigert onze crawler | Niets: de site heeft nee gezegd |
blocked_by_site_policy | De site verklaart ai-input=no | Niets: de site heeft nee gezegd |
target_refused | De site antwoordde met 403, 429, een challenge of een login | Probeer later, of vraag de site om toegang |
fetch_failed | DNS, TLS, verbinding of een 404/410-pagina | Controleer de URL; probeer later opnieuw |
fetch_timeout | De site antwoordde niet op tijd | Probeer opnieuw met een langere timeout |
concurrency_limit | Te veel verzoeken tegelijk vanaf je account | Vertraag of vraag om een hogere limiet |
invalid_api_key, insufficient_credits | Je sleutel of je saldo | Controleer het dashboard |
De foutpagina geeft elk geval in detail, met een retry-loop.
Waarom staat hier geen live uptime-cijfer?
Omdat we er nog geen hebben gemeten op een publieke steekproef, en een verzonnen cijfer je zou misleiden. Het succes van een read hangt vooral af van de site die wordt gelezen, dus één percentage zou weinig zeggen. Zodra we cijfers publiceren, komen ze met de methode, de steekproef en de datum.
Waar worden incidenten aangekondigd?
Op de changelog, met de datum, de getroffen endpoints en wat er is gedaan. Als je herhaalde fouten aan onze kant ziet (codes anders dan die door de doelsite worden veroorzaakt), schrijf dan naar [email protected] met de tijd van het verzoek en de foutcode.
Status: veelgestelde vragen
Kost het controleren van mijn credits iets?
Nee. GET https://webreaderapi.com/api/v1/credits gebruikt nooit een credit, dus je kunt het zo vaak als je wilt vanuit een health check aanroepen, binnen je concurrency-limiet.
Een pagina mislukt bij mij maar opent in mijn browser. Waarom?
Meestal omdat de site robots anders behandelt dan mensen: hij kan onze crawler weigeren in robots.txt of geautomatiseerde verzoeken beantwoorden met een challenge-pagina. We geven zijn antwoord terug en rekenen niets. De foutcode en target_status laten zien wat de site stuurde.
Worden mislukte reads ooit in rekening gebracht?
Nee. 1 credit = 1 pagina lezen zonder browser; 2 credits wanneer de pagina een browser nodig heeft om JavaScript te renderen. Een verzoek dat mislukt, of dat de robots.txt van een site weigert, wordt niet in rekening gebracht.