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:

ImeVrstaOpis
X-RateLimit-LimitintegerDovoljeno število zahtev na minuto.
X-RateLimit-RemainingintegerKoliko zahtev je še na voljo v trenutni minuti.
X-RateLimit-ResetintegerŠtevilo sekund do ponastavitve števca.
Retry-AfterintegerSamo 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_page do 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: 42
Omejitev 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."
  }
}