መጀመር

ስህተቶች

የሆነ ችግር ሲፈጠር API ተገቢውን የHTTP ሁኔታ ኮድ እና በerror ውስጥ code እና message ያለበት አካል ይመልሳል።

በፕሮግራምዎ ውስጥ codeን ይጠቀሙ። message ስህተቱን የሚያርመውን ሰው ለመርዳት የተዘጋጀ የእንግሊዝኛ ጽሑፍ ሲሆን ሊቀየር ይችላል።

የስህተት ቅርጸት404

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

ቁልፍ የሌለው401

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

የስህተት ኮዶች

ሁኔታ	ኮድ	መቼ ይከሰታል
400	`key_in_query`	ቁልፉ በአድራሻው ውስጥ ተልኳል (`api_key`፣ `apikey`፣ `key` ወይም `token` ፓራሜትሮች)። በሄደሩ ውስጥ ይላኩት እና አዲስ ቁልፍ ይፍጠሩ፤ ምክንያቱም የቀድሞው በሎጎች ውስጥ ተመዝግቦ ሊሆን ይችላል።
400	`invalid_parameter`	አንድ ፓራሜትር ልክ ያልሆነ ዋጋ አለው፤ ለምሳሌ ከከፍተኛው በላይ የሆነ `per_page`።
401	`missing_api_key`	ጥያቄው ቁልፍ አልያዘም።
401	`invalid_api_key`	ቁልፉ የለም፣ ተሽሯል ወይም ተጠቃሚው ተሰናክሏል።
404	`not_found`	ኢንድፖይንቱ የለም፤ ወይም ንጥሉ የለም ወይም ተጠቃሚው ማየት የማይችለው ድርጅት ንብረት ነው።
404	`organization_not_found`	የተሰጠው `organization` ተጠቃሚው ይህን አይነት ንጥል ማየት የሚችልበት ድርጅት አይደለም።
405	`method_not_allowed`	API የሚቀበለው `GET` (እና `HEAD`) ብቻ ነው።
429	`rate_limited`	የጥያቄዎች ገደብ ተደርሷል። በ`Retry-After` ውስጥ ያሉትን ሰከንዶች ይጠብቁ።
500	`server_error`	የውስጥ ስህተት። ከጥቂት ጊዜ በኋላ እንደገና ይሞክሩ፤ ከቀጠለ ድጋፍን ያግኙ።

ተመሳሳዩን ጥያቄ መድገም ያለብዎት ከ429 በኋላ (Retry-Afterን ጠብቀው) ወይም ከ500 በኋላ ብቻ ነው። ሌሎቹ ስህተቶች ጥያቄውን ወይም ቁልፉን ማስተካከል ይጠይቃሉ።