Rate LimitsRate Limits

Requests pro Minute nach Paket. Test-Keys unterliegen keinem Limit.

Requests per minute by package. Test keys have no limit.

Limits pro PaketLimits by Package

DISCOVER

60 / min

ASSIST

120 / min

300 / min

GROW

600 / min

PRIME

2.000 / min

Test-Key

∞

Test-Keys (bk_test_*) unterliegen keinem Rate Limit und sind ideal zum Entwickeln und Testen.Test keys (bk_test_*) have no rate limit and are great for development and testing.

Response Headers

Header	BeschreibungDescription	BeispielExample
`X-RateLimit-Limit`	Max. erlaubte Requests/MinuteMax. allowed requests per minute	`600`
`X-RateLimit-Remaining`	Verbleibende Requests im aktuellen FensterRemaining requests in current window	`587`
`X-RateLimit-Reset`	Unix-Timestamp (ms) bis Fenster-ResetUnix timestamp (ms) of window reset	`1740650460000`
`Retry-After`	Sekunden bis zum nächsten Fenster (nur bei 429)Seconds until next window (429 only)	`42`
`X-API-Version`	Aktuelle API-VersionCurrent API version	`1.3.0`

AlgorithmusAlgorithm

Sliding Window (1 Min)Sliding Window (1 min) Burst-tolerant (async)Burst-tolerant (async) Counter-TTL: 2 MinCounter TTL: 2 min

Retry-Strategie bei 429Retry Strategy on 429

Retry-After lesenRead Retry-After

Header enthält Wartezeit in Sekunden.Header contains wait time in seconds. Retry-After: 42

WartenWait

Mindestens die angegebene Sekunden warten, bevor erneut gesendet wird.Wait at least the specified seconds before retrying.

Erneut sendenRetry

Anfrage wiederholen. Bei erneutem 429 Exponentielles Backoff (2x, 4x, 8x).Retry the request. On another 429 use exponential backoff (2x, 4x, 8x).

Max. 5 VersucheMax. 5 attempts

Nach 5 Fehlversuchen Fehler an den User melden.After 5 failed attempts report the error to the user.

Retry-After nicht ignorieren. Sofortige Retries können zur temporären Sperrung führen.

Do not ignore Retry-After. Immediate retries may result in temporary blocks.

Limit erhöhenIncrease Limit

Ein 403-Response mit upgradeUrl gibt an, welches Paket den jeweiligen Endpoint freischaltet. Das Limit skaliert automatisch mit dem Paket.A 403 response with upgradeUrl indicates which package unlocks the endpoint. The limit scales automatically with your package.

# Response Headers (200 OK, GROW key): X-RateLimit-Limit: 600 X-RateLimit-Remaining: 587 X-RateLimit-Reset: 1740650460000 X-API-Version: 1.3.0 # 429 Too Many Requests (DISCOVER key): HTTP/2 429 Retry-After: 42 X-RateLimit-Limit: 60 X-RateLimit-Remaining: 0 { "success": false, "error": "Rate limit exceeded. 60 requests/minute allowed on DISCOVER.", "resetAt": "2026-03-04T14:27:40.000Z", "upgradeUrl": "https://beep.rest/developer" }

// Retry-Helper mit exponential backoff async function fetchWithRetry( action, body, retries = 5 ) { const res = await fetch( `${CF}/api/v1/${action}`, { method: 'POST', headers: { 'Authorization': `Bearer ${SK}`, 'Content-Type': 'application/json', }, body: JSON.stringify(body), } ); if (res.status === 429 && retries > 0) { const wait = (res.headers.get('Retry-After') || 5) * 1000; await new Promise( r => setTimeout(r, wait) ); return fetchWithRetry( action, body, retries - 1 ); } return res.json(); }

# Retry-Helper mit exponential backoff import time, requests def call_with_retry( action, body, retries=5 ): url = f"{CF}/api/v1/{action}" headers = { "Authorization": f"Bearer {SK}", "Content-Type": "application/json", } r = requests.post(url, json=body, headers=headers) if r.status_code == 429 and retries > 0: wait = int(r.headers.get( "Retry-After", 5 )) time.sleep(wait) return call_with_retry( action, body, retries - 1 ) return r.json()

import 'package:beep_sdk/beep_sdk.dart'; final client = BeepClient('bk_test_sk_...'); // Retry-Helper mit exponential backoff Future<Map<String, dynamic>> fetchWithRetry( Future<Map<String, dynamic>> Function() call, { int retries = 5, }) async { try { return await call(); } on RateLimitError catch (e) { if (retries <= 0) rethrow; final wait = e.retryAfter ?? 5; await Future.delayed( Duration(seconds: wait), ); return fetchWithRetry( call, retries: retries - 1, ); } } // Verwendung final stores = await fetchWithRetry( () => client.stores.list(), );