Ratenlimits und Caching

Wie viele Anfragen du senden kannst, welche Header es dir anzeigen und was du zwischenspeichern solltest.

120 Anfragen pro Minute

Jede Adresse kann pro Minute 120 Anfragen an die öffentliche API senden. Die Zählung beginnt zu Beginn jeder vollen Minute neu; RateLimit-Reset sagt dir, wie viele Sekunden bis dahin bleiben.

Header, die deinen Stand zeigen

Jede Antwort enthält RateLimit-Limit, wie viele Anfragen das Fenster erlaubt; RateLimit-Remaining, wie viele übrig sind; und RateLimit-Reset, die Sekunden, bis das Fenster neu beginnt.

HTTP

RateLimit-Limit: 120
RateLimit-Remaining: 116
RateLimit-Reset: 20

Wenn du das Limit überschreitest

Eine Anfrage über dem Limit antwortet mit 429 rate_limited und einem Retry-After-Header in Sekunden. Warte so lange bis zur nächsten Anfrage; weitere Anfragen in der Zwischenzeit verkürzen die Wartezeit nicht.

HTTP

HTTP/1.1 429 Too Many Requests
Retry-After: 37

{
  "statusCode": 429,
  "code": "rate_limited",
  "message": "Too many requests. Wait and try again."
}

Bewahre eine Kopie auf

Katalogdaten ändern sich höchstens ein paar Mal am Tag. Speichere die Antworten, die du nutzt, und aktualisiere sie nach Zeitplan, statt für jeden Besucher erneut anzufragen. Manche Antworten enthalten einen Cache-Control-Header, der angibt, wie lange sie aktuell bleiben.