Rate LimitsRate Limits

Die BEEP! API begrenzt die Anzahl der Anfragen pro Minute, abhängig von deinem Paket. Test-Keys sind unbegrenzt.

The BEEP! API limits the number of requests per minute depending on your package. Test keys are unlimited.

Limits pro Paket

PaketPackage	Requests / Minute	Burst-tolerantBurst Tolerant
DISCOVER	60	~1 req/s
ASSIST	120	~2 req/s
GO	300	~5 req/s
GROW	600	~10 req/s
PRIME	2.000	~33 req/s
Test-Keys	∞	Unbegrenzt

Algorithmus

Wir verwenden ein Sliding-Window-Verfahren mit 1-Minuten-Fenstern:

• Jede Minute beginnt ein neues Zählfenster.A new counting window starts every minute.
• Überschreitungen innerhalb eines Fensters geben 429 Too Many Requests zurück.Exceeding the limit within a window returns 429 Too Many Requests.
• Ein kleiner Burst-Overshoot ist toleriert (asynchrones Zählen).A small burst overshoot is tolerated (async counting).
• Zähler-Dokumente haben eine TTL von 2 Minuten und werden automatisch gelöscht.Counter documents have a TTL of 2 minutes and are deleted automatically.

Response Headers

Jede API-Antwort enthält Rate-Limit-Informationen:

Header	BeschreibungDescription	BeispielExample
X-RateLimit-Limit	Max. erlaubte Anfragen pro MinuteMax. allowed requests per minute	600
X-RateLimit-Remaining	Verbleibende Anfragen im aktuellen FensterRemaining requests in current window	587
X-RateLimit-Reset	Unix-Timestamp (ms) wann das Fenster sich zurücksetztUnix timestamp (ms) when the window resets	1740650460000
Retry-After	Sekunden bis zum nächsten Fenster (nur bei 429)Seconds until next window (only on 429)	42

Retry-StrategieRetry Strategy

Empfohlenes Vorgehen bei einer 429-Antwort:

1. Lese den Retry-After Header (Sekunden).Read the Retry-After header (seconds).
2. Warte die angegebene Zeit ab.Wait the specified time.
3. Sende die Anfrage erneut.Resend the request.
4. Bei erneutem 429: Exponentielles Backoff (2x, 4x, 8x …).On another 429: exponential backoff (2x, 4x, 8x …).
5. Maximal 5 Retries, dann den Fehler an den User melden.Maximum 5 retries, then report the error to the user.