Ukuqalisa

Amaphutha

Uma kukhona okungahambi kahle, i-API iphendula ngesimo se-HTTP esifanele kanye nomzimba oqukethe i-code ne-message ngaphakathi kwe-error.

Sebenzisa i-code ohlelweni lwakho. I-message ingumbhalo wesiNgisi wokusiza olungisa amaphutha, futhi ingashintsha.

Ifomethi yephutha404

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

Akukho khiye401

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

Amakhodi amaphutha

Isimo	Ikhodi	Kwenzeka nini
400	`key_in_query`	Ukhiye uthunyelwe ku-URL (amapharamitha athi `api_key`, `apikey`, `key` noma `token`). Mthumele ku-header bese udala ukhiye omusha, ngoba owangaphambili kungenzeka ukuthi ulotshwe kuma-log.
400	`invalid_parameter`	Ipharamitha inenani elingavumelekile, njenge-`per_page` engaphezu komkhawulo ophezulu.
401	`missing_api_key`	Isicelo besingenaye ukhiye.
401	`invalid_api_key`	Ukhiye akekho, uhoxisiwe, noma umsebenzisi wakhe uvaliwe.
404	`not_found`	I-endpoint ayikho, noma into ayikho noma ingeyenhlangano umsebenzisi angakwazi ukuyibona.
404	`organization_not_found`	I-`organization` enikeziwe akuyona inhlangano lapho umsebenzisi angabona khona lolu hlobo lwento.
405	`method_not_allowed`	I-API yamukela i-`GET` kuphela (ne-`HEAD`).
429	`rate_limited`	Umkhawulo wezicelo ufinyelelwe. Linda imizuzwana eku-`Retry-After`.
500	`server_error`	Iphutha langaphakathi. Zama futhi ngemuva kwesikhashana; uma liqhubeka, xhumana nosekelo.

Phinda isicelo esifanayo kuphela ngemuva kwe-429 (ulinde i-Retry-After) noma i-500. Amanye amaphutha adinga ukulungiswa kwesicelo noma kokhiye.