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:

PavadinimasTipasAprašymas
X-RateLimit-LimitintegerLeidžiamas užklausų skaičius per minutę.
X-RateLimit-RemainingintegerKiek užklausų dar liko einamąją minutę.
X-RateLimit-ResetintegerSekundės iki skaitiklio nunulinimo.
Retry-AfterintegerTik 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_page iki 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: 42
Pasiektas 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."
  }
}