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:
| Naziv | Tip | Opis |
|---|---|---|
X-RateLimit-Limit | integer | Broj dozvoljenih zahtjeva u minuti. |
X-RateLimit-Remaining | integer | Koliko zahtjeva je preostalo u tekućoj minuti. |
X-RateLimit-Reset | integer | Broj sekundi do vraćanja brojača na nulu. |
Retry-After | integer | Samo 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_pagedo 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: 42Ogranič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."
}
}