Salta ai contenuti

Errori dell'API

L’API potrebbe restituire codici di stato HTTP imprevisti, che possono indicare vari tipi di errori, da problemi di convalida dell’input a problemi di autorizzazione ed eccezioni del server.

Errori comuni dell’API

Errori di input:

  • 400 Richiesta non valida: Il corpo della richiesta non può essere elaborato. Questo indica tipicamente un problema lato client, e la risposta dovrebbe includere informazioni dettagliate sull’errore.

Errori di autorizzazione:

  • 401 Non autorizzato: La chiave dell’API non è stata rilevata. Assicurati di aver incluso il parametro URL ?apiKey=... o l’intestazione Authorization: Bearer ....
  • 403 Vietato: La chiave dell’API potrebbe non corrispondere all’intestazione Referer. Assicurati di inviare un’intestazione Referer valida con un origine appropriata, e che la chiave dell’API sia stata creata per lo stesso dominio.
  • 429 Troppe richieste: Hai superato il numero massimo di richieste consentite. Consulta la documentazione sui limiti di velocità per ulteriori informazioni.

Assicurati di gestire questi errori in modo appropriato nella logica della tua applicazione.