Առաջին քայլեր

Հարցումների սահմանաչափ

Յուրաքանչյուր օգտատեր կարող է կատարել մինչև 120 հարցում րոպեում՝ հաշվի առնելով իր բոլոր բանալիները։ Հաշվիչը զրոյանում է ժամացույցի յուրաքանչյուր րոպեի սկզբում։

Վավեր բանալու պատասխանները ցույց են տալիս սպառումը հետևյալ վերնագրերում՝

ԱնունՏեսակՆկարագրություն
X-RateLimit-LimitintegerՐոպեում թույլատրված հարցումների քանակը։
X-RateLimit-RemainingintegerՔանի հարցում է մնացել ընթացիկ րոպեում։
X-RateLimit-ResetintegerՎայրկյաններ՝ մինչև հաշվիչի զրոյացումը։
Retry-AfterintegerՄիայն 429 պատասխանում՝ քանի վայրկյան պետք է սպասել նորից փորձելուց առաջ։

Սահմանաչափը գերազանցելու դեպքում պատասխանը 429 է՝ rate_limited կոդով։ Նորից փորձելուց առաջ սպասեք 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."
  }
}