Per iniziare

Errori

Quando qualcosa va storto, l'API risponde con lo stato HTTP corrispondente e un corpo con code e message all'interno di error.

Usa code nel tuo programma. message è un testo in inglese che serve a chi esegue il debug e può cambiare.

Formato dell'errore404

{
  "error": {
    "code": "not_found",
    "message": "Item not found or you do not have access to it."
  }
}

Senza chiave401

{
  "error": {
    "code": "missing_api_key",
    "message": "Send your API key in the X-API-Key header or as Authorization: Bearer <key>."
  }
}

Codici di errore

Stato	Codice	Quando si verifica
400	`key_in_query`	La chiave è stata inviata nell'URL (parametri `api_key`, `apikey`, `key` o `token`). Inviala nell'intestazione e genera una nuova chiave, perché quella precedente potrebbe essere rimasta registrata nei log.
400	`invalid_parameter`	Un parametro ha un valore non valido, ad esempio `per_page` oltre il massimo.
401	`missing_api_key`	La richiesta non contiene una chiave.
401	`invalid_api_key`	La chiave non esiste, è stata revocata oppure il suo utente è disattivato.
404	`not_found`	L'endpoint non esiste, oppure l'elemento non esiste o appartiene a un'organizzazione che l'utente non può vedere.
404	`organization_not_found`	Il valore di `organization` indicato non corrisponde a un'organizzazione in cui l'utente può vedere questo tipo di elemento.
405	`method_not_allowed`	L'API accetta solo `GET` (e `HEAD`).
429	`rate_limited`	È stato raggiunto il limite di richieste. Attendi i secondi indicati in `Retry-After`.
500	`server_error`	Errore interno. Riprova tra qualche istante; se il problema persiste, contatta il supporto.

Quando riprovare

Ripeti la stessa richiesta solo dopo un 429 (attendendo il Retry-After) o un 500. Gli altri errori richiedono una correzione della richiesta o della chiave.