Prvi koraki
Omejitev zahtev
Vsak uporabnik lahko pošlje največ 120 zahtev na minuto, skupaj za vse svoje ključe. Števec se ponastavi ob začetku vsake minute.
Odgovori na zahteve z veljavnim ključem prikazujejo porabo v teh glavah:
| Ime | Vrsta | Opis |
|---|---|---|
X-RateLimit-Limit | integer | Dovoljeno število zahtev na minuto. |
X-RateLimit-Remaining | integer | Koliko zahtev je še na voljo v trenutni minuti. |
X-RateLimit-Reset | integer | Število sekund do ponastavitve števca. |
Retry-After | integer | Samo v odgovoru 429: število sekund, ki jih morate počakati pred ponovnim poskusom. |
Ko je omejitev presežena, je odgovor 429 s kodo rate_limited. Pred ponovnim poskusom počakajte čas, naveden v Retry-After.
Poskusi brez veljavnega ključa (brez ključa, z napačnim ali razveljavljenim ključem) so omejeni na 30 poskusov na minuto za vsak naslov IP.
Kako ostati pod omejitvijo
- Uporabite
per_pagedo 100, da z manj zahtevami pridobite več elementov. - Za spremljanje stanja televizorjev zadostuje ena zahteva na minuto.
- Pri velikih opravilih zahteve porazdelite skozi čas in spremljajte
X-RateLimit-Remaining.
Glave odgovora200
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42Omejitev dosežena429
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."
}
}