Pierwsze kroki

Limity żądań

Każdy użytkownik może wysłać maksymalnie 120 żądań na minutę, łącznie ze wszystkich swoich kluczy. Licznik zeruje się na początku każdej pełnej minuty.

Odpowiedzi na żądania z prawidłowym kluczem pokazują wykorzystanie limitu w tych nagłówkach:

Nazwa	Typ	Opis
`X-RateLimit-Limit`	`integer`	Liczba żądań dozwolonych na minutę.
`X-RateLimit-Remaining`	`integer`	Ile żądań pozostało w bieżącej minucie.
`X-RateLimit-Reset`	`integer`	Liczba sekund do wyzerowania licznika.
`Retry-After`	`integer`	Tylko w odpowiedzi `429`: liczba sekund, które musisz odczekać przed ponowną próbą.

Po przekroczeniu limitu odpowiedź ma status 429 i kod rate_limited. Przed ponowną próbą odczekaj czas podany w Retry-After.

Próby bez prawidłowego klucza (bez klucza, z błędnym lub unieważnionym kluczem) są ograniczone do 30 prób na minutę dla każdego adresu IP.

Jak nie przekroczyć limitu

Używaj per_page do 100, aby pobierać więcej elementów mniejszą liczbą żądań.
Do śledzenia statusu telewizorów wystarczy jedno żądanie na minutę.
Przy dużych zadaniach rozłóż żądania w czasie i obserwuj X-RateLimit-Remaining.

Nagłówki odpowiedzi200

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

Osiągnięto limit429

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