# Stato di WebReaderAPI: come verificare che l'API funzioni

> Come verificare che l'API di WebReaderAPI funzioni: l'endpoint dei crediti gratuito e dove vengono annunciati gli incidenti.

- URL: https://webreaderapi.com/it/status/
- Ultimo aggiornamento: 2026-10-22
- Editore: WebReaderAPI (https://webreaderapi.com)

Quando una pagina non torna, la causa è di solito il sito web, a volte la rete, e raramente noi. Questa pagina mostra come capirlo, in pochi secondi e senza spendere un credito.

**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](https://webreaderapi.com/it/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: controlla l'API e i tuoi crediti rimanenti*

```bash
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](https://webreaderapi.com/it/docs/errors/) 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](https://webreaderapi.com/it/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 support@webreaderapi.com 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.

---

WebReaderAPI: WebReaderAPI è un'API web reader per agenti AI che converte qualsiasi pagina web pubblica in Markdown pulito, con pagamento in criptovalute e senza caricare documenti d'identità. I crediti prepagati da 0,07 USD/1K pagine non scadono mai e robots.txt viene rispettato. Senza KYC — niente documento, niente selfie, niente documenti. Paga in criptovalute.