መጀመር

የጥያቄዎች ገደብ

እያንዳንዱ ተጠቃሚ በደቂቃ እስከ 120 ጥያቄዎችን መላክ ይችላል፤ ይህ የሁሉንም ቁልፎቹን ጥያቄዎች በአንድ ላይ ይቆጥራል። ቆጣሪው በእያንዳንዱ የሰዓት ደቂቃ መጀመሪያ ላይ ዜሮ ይሆናል።

ለትክክለኛ ቁልፍ የሚሰጡ ምላሾች አጠቃቀሙን በሚከተሉት ሄደሮች ያሳያሉ፦

ስም	አይነት	መግለጫ
`X-RateLimit-Limit`	`integer`	በደቂቃ የሚፈቀዱ ጥያቄዎች።
`X-RateLimit-Remaining`	`integer`	በአሁኑ ደቂቃ ውስጥ ስንት እንደቀሩ።
`X-RateLimit-Reset`	`integer`	ቆጣሪው ዜሮ እስኪሆን ድረስ ያሉት ሰከንዶች።
`Retry-After`	`integer`	በ`429` ምላሽ ውስጥ ብቻ፦ እንደገና ከመሞከርዎ በፊት መጠበቅ ያለብዎት ሰከንዶች።

ገደቡን ሲያልፉ ምላሹ rate_limited ኮድ ያለው 429 ነው። እንደገና ከመሞከርዎ በፊት በRetry-After ውስጥ ያለውን ጊዜ ይጠብቁ።

ትክክለኛ ቁልፍ የሌላቸው ሙከራዎች (ቁልፍ የሌላቸው፣ የተሳሳተ ወይም የተሻረ ቁልፍ ያላቸው) ለእያንዳንዱ የIP አድራሻ በደቂቃ 30 ብቻ ይፈቀዳሉ።

ገደቡ ላይ ላለመድረስ

በጥቂት ጥያቄዎች ብዙ ንጥሎችን ለማግኘት per_pageን እስከ 100 ድረስ ይጠቀሙ።
የቲቪዎችን ሁኔታ ለመከታተል በደቂቃ አንድ ጥያቄ በቂ ነው።
በትልልቅ ሥራዎች ጥያቄዎቹን በጊዜ ሂደት ያሰራጩ እና X-RateLimit-Remainingን ይከታተሉ።

የአንድ ምላሽ ሄደሮች200

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42

ገደቡ ተደርሷል429

HTTP/1.1 429 Too Many Requests
Retry-After: 18
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 18

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again in 18 seconds."
  }
}