Prvi koraci

Ograničenje zahtjeva

Svaki korisnik može poslati do 120 zahtjeva u minuti, zbirno za sve svoje ključeve. Brojač se vraća na nulu na početku svake minute po satu.

Odgovori na zahtjeve s važećim ključem prikazuju potrošnju u ovim zaglavljima:

NazivTipOpis
X-RateLimit-LimitintegerBroj dozvoljenih zahtjeva u minuti.
X-RateLimit-RemainingintegerKoliko zahtjeva je preostalo u tekućoj minuti.
X-RateLimit-ResetintegerBroj sekundi do vraćanja brojača na nulu.
Retry-AfterintegerSamo u odgovoru 429: broj sekundi koje treba sačekati prije novog pokušaja.

Kada se ograničenje prekorači, odgovor je 429 s kodom rate_limited. Sačekajte vrijeme iz Retry-After prije novog pokušaja.

Pokušaji bez važećeg ključa (bez ključa, s pogrešnim ili opozvanim ključem) ograničeni su na 30 pokušaja u minuti po IP adresi.

Kako ne doći do ograničenja

  • Koristite per_page do 100 da dobijete više stavki s manje zahtjeva.
  • Za praćenje statusa TV uređaja dovoljan je jedan zahtjev u minuti.
  • Kod velikih zadataka rasporedite zahtjeve kroz vrijeme i pratite X-RateLimit-Remaining.
Zaglavlja 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
Ograničenje je dostignuto429
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."
  }
}