Kuanza

Hitilafu

Kitu kikienda vibaya, API hujibu kwa hali ya HTTP inayolingana na mwili wa jibu wenye code na message ndani ya error.

Tumia code kwenye programu yako. message ni maandishi ya Kiingereza ya kumsaidia anayetatua hitilafu, na yanaweza kubadilika.

Muundo wa hitilafu404

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

Bila ufunguo401

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

Misimbo ya hitilafu

Hali	Msimbo	Hutokea lini
400	`key_in_query`	Ufunguo ulitumwa kwenye anwani (vigezo `api_key`, `apikey`, `key` au `token`). Utume kwenye kichwa na uunde ufunguo mpya, kwa sababu ule wa awali huenda umerekodiwa kwenye logi.
400	`invalid_parameter`	Kigezo kina thamani batili, kama `per_page` inayozidi kiwango cha juu.
401	`missing_api_key`	Ombi halikuwa na ufunguo.
401	`invalid_api_key`	Ufunguo haupo, umebatilishwa au mtumiaji wake amezimwa.
404	`not_found`	Endpoint haipo, au kipengee hakipo au ni cha shirika ambalo mtumiaji hawezi kuliona.
404	`organization_not_found`	`organization` uliyotoa si shirika ambamo mtumiaji anaweza kuona aina hii ya kipengee.
405	`method_not_allowed`	API inakubali `GET` pekee (na `HEAD`).
429	`rate_limited`	Kikomo cha maombi kimefikiwa. Subiri sekunde zilizo kwenye `Retry-After`.
500	`server_error`	Hitilafu ya ndani. Jaribu tena baada ya muda mfupi; ikiendelea, wasiliana na usaidizi.

Rudia ombi lile lile tu baada ya 429 (ukisubiri Retry-After) au 500. Hitilafu nyingine zinahitaji marekebisho kwenye ombi au ufunguo.