Primii pași

Erori

Când ceva nu merge bine, API-ul răspunde cu codul de stare HTTP corespunzător și cu un corp care conține code și message în error.

Folosiți code în programul dumneavoastră. message este un text în engleză, menit să ajute la depanare, și se poate schimba.

Formatul erorii404

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

Fără cheie401

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

Coduri de eroare

Stare	Cod	Când apare
400	`key_in_query`	Cheia a fost trimisă în URL (parametrii `api_key`, `apikey`, `key` sau `token`). Trimiteți-o în antet și generați o cheie nouă, deoarece cea anterioară poate să fi rămas înregistrată în loguri.
400	`invalid_parameter`	Un parametru are o valoare invalidă, de exemplu `per_page` peste valoarea maximă.
401	`missing_api_key`	Cererea nu a inclus nicio cheie.
401	`invalid_api_key`	Cheia nu există, a fost revocată sau utilizatorul ei este dezactivat.
404	`not_found`	Endpointul nu există sau elementul nu există ori aparține unei organizații pe care utilizatorul nu o poate vedea.
404	`organization_not_found`	Valoarea `organization` indicată nu corespunde unei organizații în care utilizatorul poate vedea acest tip de element.
405	`method_not_allowed`	API-ul acceptă doar `GET` (și `HEAD`).
429	`rate_limited`	Limita de cereri a fost atinsă. Așteptați numărul de secunde din `Retry-After`.
500	`server_error`	Eroare internă. Încercați din nou în câteva momente; dacă problema persistă, contactați asistența.

Când să încercați din nou

Repetați aceeași cerere doar după un 429 (după ce așteptați Retry-After) sau după un 500. Celelalte erori necesită o corectare a cererii sau a cheii.