Risposta rapida
Come faccio a sapere se WebReaderAPI funziona?
Chiama GET https://webreaderapi.com/api/v1/credits con la tua chiave: è gratuito, e una risposta normale significa che l'API e la tua chiave funzionano. Se una pagina fallisce, il codice di errore ti spiega perché, e WebReaderAPI non addebita nulla. Gli incidenti dalla nostra parte sono registrati nel changelog con la loro data.
Qual è il controllo di stato più veloce?
L'endpoint dei crediti. Risponde senza recuperare alcun sito web, quindi mette alla prova solo la nostra parte: l'autenticazione, l'API e il tuo account.
curl -s https://webreaderapi.com/api/v1/credits -H "Authorization: Bearer $WEBREADER_API_KEY"
Quali errori vengono dal sito web e quali da noi?
Il codice di errore dice dov'è il problema. Nessuno di questi errori usa un credito.
| Codice | Dov'è il problema | Cosa fare |
|---|---|---|
blocked_by_robots | Il robots.txt del sito rifiuta il nostro crawler | Nulla: il sito ha detto no |
blocked_by_site_policy | Il sito dichiara ai-input=no | Nulla: il sito ha detto no |
target_refused | Il sito ha risposto 403, 429, una challenge o un login | Riprova più tardi, oppure chiedi accesso al sito |
fetch_failed | DNS, TLS, connessione, o una pagina 404/410 | Controlla l'URL; riprova più tardi |
fetch_timeout | Il sito non ha risposto in tempo | Riprova con un timeout più lungo |
concurrency_limit | Troppe richieste contemporanee dal tuo account | Rallenta o chiedi un limite più alto |
invalid_api_key, insufficient_credits | La tua chiave o il tuo saldo | Controlla la dashboard |
La pagina degli errori descrive ogni caso in dettaglio, con un ciclo di retry.
Perché qui non c'è un dato di uptime in tempo reale?
Perché non ne abbiamo ancora misurato uno su un campione pubblico, e una cifra inventata ti ingannerebbe. Il successo di una lettura dipende soprattutto dal sito che si legge, quindi una singola percentuale direbbe poco. Quando pubblicheremo dei dati, arriveranno con il metodo, il campione e la data.
Dove vengono annunciati gli incidenti?
Nel changelog, con la data, gli endpoint coinvolti e cosa è stato fatto. Se vedi errori ripetuti dalla nostra parte (codici diversi da quelli causati dal sito di destinazione), scrivi a [email protected] con l'ora della richiesta e il codice di errore.
Stato: domande frequenti
Controllare i miei crediti costa qualcosa?
No. GET https://webreaderapi.com/api/v1/credits non usa mai un credito, quindi puoi chiamarlo da un controllo di stato tutte le volte che vuoi, entro il tuo limite di concorrenza.
Una pagina fallisce con me ma si apre nel mio browser. Perché?
Di solito perché il sito tratta i robot diversamente dalle persone: può rifiutare il nostro crawler nel robots.txt o rispondere alle richieste automatizzate con una pagina di challenge. Restituiamo la sua risposta e non addebitiamo nulla. Il codice di errore e target_status mostrano cosa ha inviato il sito.
Le letture fallite vengono mai addebitate?
No. 1 credito = 1 pagina letta senza browser; 2 crediti quando la pagina richiede un browser per eseguire JavaScript. Una richiesta che fallisce, o che il robots.txt di un sito rifiuta, non viene addebitata.