Kom igång

Anropsgränser

Varje användare kan göra upp till 120 anrop per minut, sammanlagt för alla sina nycklar. Räknaren nollställs i början av varje klockminut.

Svar på anrop med en giltig nyckel visar förbrukningen i dessa headers:

Namn	Typ	Beskrivning
`X-RateLimit-Limit`	`integer`	Tillåtna anrop per minut.
`X-RateLimit-Remaining`	`integer`	Hur många som återstår under den aktuella minuten.
`X-RateLimit-Reset`	`integer`	Sekunder tills räknaren nollställs.
`Retry-After`	`integer`	Bara i svaret `429`: antal sekunder du ska vänta innan du försöker igen.

Över gränsen blir svaret 429 med koden rate_limited. Vänta den tid som anges i Retry-After innan du försöker igen.

Försök utan giltig nyckel (ingen nyckel, fel nyckel eller återkallad nyckel) är begränsade till 30 per minut för varje IP-adress.

Så håller du dig under gränsen

Använd per_page upp till 100 för att hämta fler objekt med färre anrop.
För att följa TV-apparaternas status räcker det med ett anrop per minut.
Vid stora jobb bör du sprida ut anropen över tid och hålla koll på X-RateLimit-Remaining.

Headers i ett svar200

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42

Gränsen nådd429

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."
  }
}