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:
| Nume | Tip | Descriere |
|---|---|---|
X-RateLimit-Limit | integer | Cereri permise pe minut. |
X-RateLimit-Remaining | integer | Câte cereri mai rămân în minutul curent. |
X-RateLimit-Reset | integer | Secunde până la resetarea contorului. |
Retry-After | integer | Doar î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_pagepâ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: 42Limită 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."
}
}