Pradžia
Užklausų apribojimai
Kiekvienas naudotojas gali atlikti iki 120 užklausų per minutę, sudėjus visus jo raktus. Skaitiklis nunulinamas kiekvienos laikrodžio minutės pradžioje.
Atsakymuose į užklausas su galiojančiu raktu sunaudojimas rodomas šiose antraštėse:
| Pavadinimas | Tipas | Aprašymas |
|---|---|---|
X-RateLimit-Limit | integer | Leidžiamas užklausų skaičius per minutę. |
X-RateLimit-Remaining | integer | Kiek užklausų dar liko einamąją minutę. |
X-RateLimit-Reset | integer | Sekundės iki skaitiklio nunulinimo. |
Retry-After | integer | Tik atsakyme 429: kiek sekundžių reikia palaukti prieš bandant dar kartą. |
Viršijus apribojimą, atsakymas yra 429 su kodu rate_limited. Prieš bandydami dar kartą, palaukite Retry-After nurodytą laiką.
Bandymai be galiojančio rakto (be rakto, su neteisingu arba panaikintu raktu) ribojami iki 30 bandymų per minutę kiekvienam IP adresui.
Kad nepasiektumėte apribojimo
- Naudokite
per_pageiki 100, kad mažesniu užklausų skaičiumi gautumėte daugiau elementų. - Televizorių būsenai stebėti pakanka vienos užklausos per minutę.
- Atlikdami didelius darbus, paskirstykite užklausas laike ir stebėkite
X-RateLimit-Remaining.
Atsakymo antraštės200
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42Pasiektas apribojimas429
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."
}
}