Primii pași

Limita de cereri

Fiecare utilizator poate face până la 120 de cereri pe minut, cumulat pentru toate cheile sale. Contorul se resetează la începutul fiecărui minut.

Răspunsurile pentru o cheie validă arată consumul în aceste anteturi:

NumeTipDescriere
X-RateLimit-LimitintegerCereri permise pe minut.
X-RateLimit-RemainingintegerCâte cereri mai rămân în minutul curent.
X-RateLimit-ResetintegerSecunde până la resetarea contorului.
Retry-AfterintegerDoar în răspunsul 429: câte secunde trebuie să așteptați înainte de a încerca din nou.

Peste limită, răspunsul este 429 cu codul rate_limited. Așteptați timpul indicat în Retry-After înainte de a încerca din nou.

Încercările fără o cheie validă (fără cheie, cu o cheie greșită sau revocată) sunt limitate la 30 pe minut pentru fiecare adresă IP.

Pentru a nu atinge limita

  • Folosiți per_page până la 100 pentru a obține mai multe elemente cu mai puține cereri.
  • Pentru a urmări starea TV-urilor, este suficientă o cerere pe minut.
  • Pentru operațiuni mari, distribuiți cererile în timp și urmăriți X-RateLimit-Remaining.
Anteturile unui răspuns200
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42
Limită atinsă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."
  }
}