Gestione degli errori
Impara a gestire gli errori API in modo elegante nella tua applicazione
Quando si verifica un errore durante una richiesta API, AllNewsAPI restituisce una risposta di errore in formato JSON con un codice di stato e un involucro standardizzato. Il corpo della risposta contiene sempre un oggetto di dettaglio con un campo messaggio che descrive l'errore. Questa guida illustra ciascun errore e come gestirlo.
Formato di risposta agli errori
Tutte le risposte di errore delle API (4xx e 5xx) utilizzano un formato JSON coerente. Il campo detail.message contiene sempre una descrizione dell'errore leggibile dall'uomo.
Codici di errore
400 Richiesta non valida
La tua richiesta non è formattata correttamente o mancano i parametri obbligatori. Verifica i parametri della query e riprova.
401 Accesso non autorizzato
La tua chiave API non è valida o manca. Verifica che la tua chiave API sia corretta e inclusa nella richiesta.
403 Vietato
Il tuo account non dispone delle autorizzazioni necessarie per questa richiesta. Ciò può accadere se stai tentando di accedere a funzionalità premium con un piano gratuito.
429 Troppe richieste
Hai superato il limite di richieste giornaliere. Attendi che il limite si azzeri alle 00:00 UTC oppure passa a un piano superiore.
503 Servizio non disponibile
L'API è temporaneamente non disponibile per manutenzione. Si prega di riprovare tra qualche minuto.
Esempio:
Procedure ottimali per la gestione degli errori
- Verificare sempre il codice di stato della risposta prima di elaborare i dati.
- Implementare un backoff esponenziale per ritentare le richieste non riuscite
- Estrai il messaggio di errore da response.detail.message per una visualizzazione più intuitiva da parte dell'utente.