Rate-Limits
Limits der BrewForge-API (REST 100 Anfragen pro Stunde und 1.000 pro 30 Tage, Actions-API und MCP 600 pro Stunde und 20.000 pro 30 Tage), Rate-Limit-Header und der Umgang mit 429-Antworten
Die API begrenzt, wie viele Anfragen du stellen kannst, damit sie für alle fair und stabil bleibt.
Limits
Die Limits gelten pro Konto (nicht pro Token), mehrere Token eines Kontos teilen sie sich also. Beide Zeitfenster sind gleitend:
Die REST-API und die Actions-API mit dem MCP-Server zählen getrennt, jede mit eigenen Limits:
| Zeitfenster | REST-API (/api/v1/brews, …) | Actions-API und MCP-Server |
|---|---|---|
| Pro Stunde | 100 Anfragen | 600 Anfragen |
| Pro 30 Tage | 1.000 Anfragen | 20.000 Anfragen |
Das Actions-Limit ist höher, weil Agenten viele kleine Aufrufe machen (erst nachschlagen, dann handeln). Beim MCP-Server zählt jede Anfrage, auch wenn der Client die Tools abfragt.
Die Rechner-API hat ein eigenes Limit pro IP-Adresse und zählt hier nicht mit.
Rate-Limit-Header
Erfolgreiche Antworten und 429-Antworten enthalten Header mit deinem aktuellen Verbrauch:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1706234400000| Header | Bedeutung |
|---|---|
X-RateLimit-Limit | Erlaubte Anfragen im Zeitfenster: das Stundenlimit, oder das 30-Tage-Limit, sobald das aufgebraucht ist |
X-RateLimit-Remaining | Verbleibende Anfragen: der kleinere Rest aus dieser Stunde und den 30 Tagen |
X-RateLimit-Reset | Unix-Zeitstempel in Millisekunden, wann das Zeitfenster zurückgesetzt wird |
429 Too Many Requests
Wenn du ein Limit überschreitest:
{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded",
"details": {
"retryAfter": 45
}
}
}Der Header Retry-After (und details.retryAfter) sagt dir, wie viele Sekunden du warten sollst. Actions-API und MCP-Server antworten in ihrem Fehlerformat, mit den Sekunden in der Meldung und in details.retry_after_s:
{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit reached. Try again in 45 seconds.",
"details": { "retry_after_s": 45 }
}
}Beide senden den Header:
HTTP/1.1 429 Too Many Requests
Retry-After: 45Empfehlungen
- Antworten zwischenspeichern: Hol dieselben Daten nicht immer wieder ab
- Seitenweise abrufen: Hol mit dem Parameter
limitnur, was du brauchst (höchstens 100 pro Seite) - Änderungen bündeln: Fasse mehrere Änderungen zusammen, wo es geht
- 429 sauber behandeln: Warte
Retry-Afterab und wiederhole dann mit exponentiellem Backoff
Beispiel für exponentiellen Backoff
async function fetchWithRetry(url, options, maxRetries = 3) {
for (let i = 0; i < maxRetries; i++) {
const response = await fetch(url, options);
if (response.status === 429) {
const retryAfter = response.headers.get('Retry-After') || 60;
await new Promise(r => setTimeout(r, retryAfter * 1000));
continue;
}
return response;
}
throw new Error('Max retries exceeded');
}