Öffentliche API
Rate Limits
RateLimit-Antwortheader, Retry-After und Behandlung von 429
Limits gelten pro API-Schlüssel mit einem festen Zeitfenster (Standard 120 Anfragen / 60 Sekunden). Die genauen Werte können serverseitig konfiguriert sein.
Antwortheader
Jede authentifizierte Public-API-Antwort enthält:
| Header | Bedeutung |
|---|---|
RateLimit-Limit | Maximale Anfragen im aktuellen Fenster |
RateLimit-Remaining | Verbleibende Anfragen im Fenster |
RateLimit-Reset | Unix-Zeitstempel (Sekunden), wann das Fenster zurückgesetzt wird |
Wenn das Limit überschritten wird
Die API antwortet mit 429 Too Many Requests und:
Retry-After— Sekunden bis zum nächsten Versuchapplication/problem+jsonmit Typhttps://cowtic.com/problems/rate-limited
HTTP/1.1 429 Too Many Requests
RateLimit-Limit: 120
RateLimit-Remaining: 0
RateLimit-Reset: 1721491200
Retry-After: 60
Content-Type: application/problem+jsonHinweise für Clients
- Lesen Sie
RateLimit-Remainingund drosseln Sie Anfragen, bevor der Wert null erreicht. - Bei
429mindestensRetry-AfterSekunden warten (zusätzliches exponential backoff ist sinnvoll). - Burst-Last vermeiden; Hintergrundjobs statt enger Schleifen bevorzugen.
- Pro Integration eigene Schlüssel nutzen, wenn Sie unabhängige Kontingente brauchen.