Алғашқы қадамдар

Сұраныстар шегі

Әр пайдаланушы барлық кілттерін қосқанда минутына 120 сұранысқа дейін жібере алады. Есептегіш сағат бойынша әр минуттың басында нөлденеді.

Жарамды кілтке берілетін жауаптар пайдалану көлемін мына тақырыптарда көрсетеді:

АтауыТүріСипаттамасы
X-RateLimit-LimitintegerМинутына рұқсат етілген сұраныстар саны.
X-RateLimit-RemainingintegerАғымдағы минутта қалған сұраныстар саны.
X-RateLimit-ResetintegerЕсептегіш нөлденгенге дейінгі секундтар саны.
Retry-AfterintegerТек 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."
  }
}