Bilaabidda

Khaladaadka

Marka wax khaldamaan, API-gu wuxuu ku jawaabaa xaaladda HTTP ee u dhiganta iyo jir ay ku jiraan code iyo message gudaha error.

Barnaamijkaaga ku isticmaal code. message waa qoraal Ingiriisi ah oo loogu talagalay in lagu caawiyo qofka cilladda baaraya, wuuna isbeddeli karaa.

Qaabka khaladka404

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

Fure la'aan401

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

Koodhadhka khaladaadka

Xaalad	Kood	Goorta ay dhacdo
400	`key_in_query`	Furaha waxaa lagu soo diray cinwaanka (halbeegyada `api_key`, `apikey`, `key` ama `token`). Ku dir header-ka oo samee fure cusub, maxaa yeelay kii hore waxaa laga yaabaa in lagu kaydiyay log-yada.
400	`invalid_parameter`	Halbeeg ayaa leh qiime khaldan, sida `per_page` oo ka badan inta ugu badan.
401	`missing_api_key`	Codsigu fure ma lahayn.
401	`invalid_api_key`	Furuhu ma jiro, waa la buriyay, ama isticmaalihiisa waa la joojiyay.
404	`not_found`	Endpoint-ku ma jiro, ama walaxdu ma jirto ama waxay ka tirsan tahay urur uusan isticmaaluhu arki karin.
404	`organization_not_found`	`organization`-ka la bixiyay ma aha urur uu isticmaaluhu ku arki karo noocan walxaha ah.
405	`method_not_allowed`	API-gu wuxuu aqbalaa `GET` oo keliya (iyo `HEAD`).
429	`rate_limited`	Xadka codsiyada waa la gaaray. Sug ilbiriqsiyada ku qoran `Retry-After`.
500	`server_error`	Khalad gudaha ah. Isku day mar kale wax yar kadib; haddii uu sii socdo, la xiriir taageerada.

Goorta mar kale la isku dayo

Isla codsiga ku celi oo keliya kadib 429 (adigoo sugaya Retry-After) ama 500. Khaladaadka kale waxay u baahan yihiin in la saxo codsiga ama furaha.