Rate Limiting
Informationen zu Anfragelimits und deren Handhabung.
Anfragelimits
Das Anfragelimit wird für jeden API-Schlüssel einzeln von Ihrem Administrator im Adminbereich unter Einstellungen > API festgelegt. Es hängt nicht von Ihrem Abonnement-Paket ab.
| Standard pro API-Schlüssel | 1.000 Anfragen pro Stunde |
|---|---|
| Einstellbarer Bereich | 100 bis 10.000 Anfragen pro Stunde (eine unbegrenzte Option gibt es nicht) |
| Zeitfenster | Gleitende 60 Minuten: Gezählt werden alle Anfragen der letzten Stunde, auch abgelehnte |
| Zählung | Jeder API-Schlüssel wird separat gezählt |
Ihr Abonnement-Paket entscheidet nur darüber, ob der API-Zugang überhaupt enthalten ist. Ohne API-Zugang wird jede Anfrage mit 403 und dem Hinweis abgelehnt, dass der API-Zugang nicht in Ihrem Paket enthalten ist.
Rate-Limit-Header
Die unten aufgeführten X-RateLimit-*-Header sind für eine zukünftige Version geplant und werden derzeit noch nicht gesendet. Aktuell liefert eine Anfrage über dem Limit den Status 429 mit einem Retry-After-Header (in Sekunden).
| Header | Beschreibung |
|---|---|
X-RateLimit-Limit |
Maximale Anzahl Anfragen pro Stunde |
X-RateLimit-Remaining |
Verbleibende Anfragen im aktuellen Zeitfenster |
X-RateLimit-Reset |
Unix-Timestamp, wann das Limit zurückgesetzt wird |
Limit überschritten
Wenn das Limit überschritten wird, erhalten Sie eine 429-Antwort:
HTTP/1.1 429 Too Many Requests
Retry-After: 60
Content-Type: application/json
{
"error": "Rate limit exceeded"
}Die Fehlermeldung ist lokalisiert. Prüfen Sie daher den HTTP-Statuscode 429 und nicht den Text. Warten Sie vor einem erneuten Versuch mindestens die in Retry-After angegebenen Sekunden; Anfragen werden wieder angenommen, sobald ältere Anfragen aus dem 60-Minuten-Fenster herausfallen.