Ratenbegrenzung

Allgemeine Anfragebeschränkungen

Die API ist auf 150 Anfragen pro 60 Sekunden begrenzt. Alle Anfragen zählen zum Gesamtlimit. Jede von der API verarbeitete Anfrage gibt Informationen zur Ratenbegrenzung in den HTTP-Headern zurück.

Hinweis: Die Ratenbegrenzung basiert sowohl auf dem Benutzernamen als auch auf der IP-Adresse. Daher ist ein einzelner Benutzername auf 150 Anfragen pro 60 Sekunden begrenzt, ebenso wie eine einzelne IP-Adresse.

Login-Anfragebeschränkungen

Login-Anfragen sind auf 10 Anfragen pro 60 Sekunden. Alle Anfragen zählen zum Gesamtlimit.

Hinweis: Die IP-Adresse und der Benutzername jeder ausgeführten Statistik-Anfrage werden auf diese Limits angerechnet.

Beschränkungen für Statistik-Anfragen

Statistik-Anfragen sind für jede IP-Adresse auf 30 Anfragen pro Minute und für jeden Benutzernamen auf 25 Anfragen pro Minute begrenzt.

Hinweis: Die IP-Adresse und der Benutzername jeder ausgeführten Statistik-Anfrage werden auf diese Limits angerechnet.

Wenn Sie sich beispielsweise mit Ihrem Benutzernamen auf einem einzelnen Computer anmelden und 25 Statistik-Anfragen stellen, wird die nächste fehlschlagen. Sie könnten jedoch zu einem anderen Benutzernamen wechseln und 5 weitere Statistik-Anfragen stellen, bevor Sie das Limit für die IP-Adresse erreichen.

Beispiele

Ratenbegrenzung – Beispiel 1

$ curl -i https://api.example.com/v2/statistics/a/date

{
  "HTTP/1.1": "200 OK",
  "Date": "Fri, 24 Oct 2014 14:57:32 GMT",
  "Content-Type": "application/json",
  "Transfer-Encoding": "chunked",
  "X-Rate-Limit-Limit": 25,
  "X-Rate-Limit-Remaining": 44,
  "X-Rate-Limit-Reset": 27
}

Wenn das Rate-Limit überschritten wird, wird ein 429 Too Many Requests HTTP-Fehler bei allen nachfolgenden Anfragen ausgelöst, bis das Rate-Limit zurückgesetzt wird. Wie bei einer normalen Anfrage sind die Informationen zur Ratenbegrenzung in den HTTP-Headern verfügbar.

Ratenbegrenzung – Beispiel 2 (Limit überschritten)

$ curl -i https://api.example.com/v2/statistics/a/date

{
  "HTTP/1.1": "429 Too Many Requests",
  "Date": "Fri, 24 Oct 2014 15:04:35 GMT",
  "Content-Type": "application/json",
  "Transfer-Encoding": "chunked",
  "X-Rate-Limit-Limit": 25,
  "X-Rate-Limit-Remaining": 0,
  "X-Rate-Limit-Reset": 12
}