Erste Schritte

Anfragelimits

Jeder Benutzer kann bis zu 120 Anfragen pro Minute stellen, über alle seine Schlüssel zusammengerechnet. Der Zähler wird zu jeder vollen Minute zurückgesetzt.

Antworten auf Anfragen mit einem gültigen Schlüssel zeigen den Verbrauch in diesen Headern:

Name	Typ	Beschreibung
`X-RateLimit-Limit`	`integer`	Erlaubte Anfragen pro Minute.
`X-RateLimit-Remaining`	`integer`	Wie viele in der aktuellen Minute noch übrig sind.
`X-RateLimit-Reset`	`integer`	Sekunden, bis der Zähler zurückgesetzt wird.
`Retry-After`	`integer`	Nur in der Antwort `429`: Sekunden, die Sie warten sollten, bevor Sie es erneut versuchen.

Wird das Limit überschritten, lautet die Antwort 429 mit dem Code rate_limited. Warten Sie die in Retry-After angegebene Zeit ab, bevor Sie es erneut versuchen.

Versuche ohne gültigen Schlüssel (ohne Schlüssel, mit falschem oder mit widerrufenem Schlüssel) sind auf 30 pro Minute und IP-Adresse begrenzt.

So bleiben Sie unter dem Limit

Verwenden Sie per_page mit bis zu 100, um mehr Elemente mit weniger Anfragen abzurufen.
Um den Status der TVs zu verfolgen, reicht eine Anfrage pro Minute.
Verteilen Sie bei großen Aufgaben die Anfragen über die Zeit und behalten Sie X-RateLimit-Remaining im Blick.

Header einer Antwort200

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

Limit erreicht429

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