Hapat e parë

Gabimet

Kur diçka shkon keq, API-ja përgjigjet me statusin HTTP përkatës dhe me një trup që përmban code dhe message brenda error.

Në programin tuaj përdorni code. message është një tekst në anglisht për të ndihmuar këdo që po korrigjon gabimet dhe mund të ndryshojë.

Formati i gabimit404

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

Pa çelës401

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

Kodet e gabimit

Statusi	Kodi	Kur ndodh
400	`key_in_query`	Çelësi u dërgua në URL (parametrat `api_key`, `apikey`, `key` ose `token`). Dërgojeni në kokë dhe krijoni një çelës të ri, sepse i mëparshmi mund të jetë regjistruar në log-e.
400	`invalid_parameter`	Një parametër ka vlerë të pavlefshme, si p.sh. `per_page` mbi maksimumin.
401	`missing_api_key`	Kërkesa nuk përmbante çelës.
401	`invalid_api_key`	Çelësi nuk ekziston, është shfuqizuar ose përdoruesi i tij është çaktivizuar.
404	`not_found`	Pika fundore nuk ekziston, ose elementi nuk ekziston ose i përket një organizate që përdoruesi nuk mund ta shohë.
404	`organization_not_found`	`organization` i dhënë nuk është një organizatë ku përdoruesi mund ta shohë këtë lloj elementi.
405	`method_not_allowed`	API-ja pranon vetëm `GET` (dhe `HEAD`).
429	`rate_limited`	U arrit kufiri i kërkesave. Prisni sekondat e treguara te `Retry-After`.
500	`server_error`	Gabim i brendshëm. Provoni përsëri pas pak; nëse vazhdon, kontaktoni mbështetjen.

Kur të provoni përsëri

Ia vlen ta përsërisni të njëjtën kërkesë vetëm pas një 429 (duke pritur Retry-After) ose një 500. Gabimet e tjera kërkojnë një korrigjim në kërkesë ose në çelës.