Առաջին քայլեր
Հարցումների սահմանաչափ
Յուրաքանչյուր օգտատեր կարող է կատարել մինչև 120 հարցում րոպեում՝ հաշվի առնելով իր բոլոր բանալիները։ Հաշվիչը զրոյանում է ժամացույցի յուրաքանչյուր րոպեի սկզբում։
Վավեր բանալու պատասխանները ցույց են տալիս սպառումը հետևյալ վերնագրերում՝
| Անուն | Տեսակ | Նկարագրություն |
|---|---|---|
X-RateLimit-Limit | integer | Րոպեում թույլատրված հարցումների քանակը։ |
X-RateLimit-Remaining | integer | Քանի հարցում է մնացել ընթացիկ րոպեում։ |
X-RateLimit-Reset | integer | Վայրկյաններ՝ մինչև հաշվիչի զրոյացումը։ |
Retry-After | integer | Միայն 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."
}
}