Risposte ed errori
Le risposte dell’API sono sempre in formato JSON e contengono i seguenti campi:
| Nome | Tipo | Descrizione |
|---|---|---|
error | boolean | Indica se si è verificato un errore durante l'elaborazione della richiesta |
message | string | Messaggio di errore o conferma del successo della richiesta |
status | number | Codice di stato HTTP della risposta |
data | object | Contiene i dati richiesti, se la richiesta ha avuto successo |
timestamp | number | Timestamp della risposta in millisecondi dall'inizio dell'epoca UNIX |
eventId | string | ID univoco dell'evento per il tracciamento delle richieste |
code | string | Codice di errore interno, utile per il debug e la segnalazione di problemi |
overQuota | boolean | Indica se la richiesta ha superato il limite di quota mensile per l'API |
Puoi verificare in tempo reale il comportamento dell'API tramite il playground. Le richieste effettuate dal playground non sono soggette a quota mensile.
Esempio di risposta di successo:
Errori comuni
Ogni errore restituito dall’API include un messaggio di errore e un codice di errore interno.
| Codice interno | Status | Soluzione |
|---|---|---|
BAD_REQUEST | 400 | La richiesta non è valida. Controlla i parametri e il formato della richiesta. |
MISSING_API_KEY | 401 | La chiave API non è stata fornita. Assicurati di includere la chiave API nell'header della richiesta sotto la voce x-api-key. |
INVALID_API_KEY | 401 | La chiave API fornita non è valida. Controlla che la chiave sia corretta e attiva. |
NO_ACTIVE_SUBSCRIPTION | 403 | Non hai una sottoscrizione attiva. Controlla la tua sottoscrizione dalla sezione Profilo › Fatturazione. |
INCOMPLETE_SUBSCRIPTION | 403 | L'acquisto della tua sottoscrizione non è stato ancora completato, vai al portale di fatturazione per completarlo. |
PAST_DUE_SUBSCRIPTION | 403 | La tua sottoscrizione è scaduta. Controlla la tua sottoscrizione dalla sezione Profilo › Fatturazione. |
MONTHLY_QUOTA_EXCEEDED | 429 | Hai superato il limite di richieste mensili per il tuo piano, e non è possibile addebitare richieste extra. Puoi migrare a un piano superiore o attendere il mese successivo per ripristinare la tua quota. |
DAILY_LIMIT_EXCEEDED | 429 | Hai superato il limite di richieste giornaliere per il tuo piano. Puoi migrare a un piano superiore o attendere il giorno successivo per ripristinare la tua quota. |
BURST_LIMIT_EXCEEDED | 429 | Hai superato il limite di richieste al secondo per il tuo piano. Puoi migrare a un piano superiore o ridurre la frequenza delle tue richieste. |
UNEXPECTED_ERROR | 500 | Si è verificato un errore imprevisto. Riprova più tardi o contatta il supporto. |