Skip to main content

Ratenbegrenzung

Allgemeine Antragsgrenzen​

Die API ist auf 150 Anfragen alle 60 Sekunden begrenzt. Alle Anfragen zählen für diese Gesamtzahl. 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 alle 60 Sekunden begrenzt, ebenso wie eine einzelne IP-Adresse.

Grenzwerte für Statistikanfragen​

Die Anzahl der Statistikanfragen ist auf 30 Anfragen pro Minute für jede IP-Adresse und 25 Anfragen pro Minute für jeden Benutzernamen begrenzt.

Anmerkung: Die IP und der Benutzername jeder Statistikanfrage werden auf diese Grenzen angerechnet.

Wenn Sie sich beispielsweise mit Ihrem Benutzernamen auf einem einzigen Computer anmelden und 25 Statistikanfragen stellen, wird die nächste Anfrage fehlschlagen. Sie können jedoch zu einem anderen Benutzernamen wechseln und 5 weitere Statistikanfragen stellen, bevor die IP-Adressgrenze erreicht ist.

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 die Ratenbegrenzung überschritten wird, wird bei allen nachfolgenden Anfragen ein 429 Too Many Requests HTTP-Fehler ausgelöst, bis die Ratenbegrenzung zurückgesetzt wird. Wie bei einer normalen Anfrage sind die Informationen zur Ratenbegrenzung in den HTTP-Headern verfügbar.

Ratenbegrenzung - Beispiel 2 (Überschreitung des Limits)​


$ 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
    }