BrewForge Docs

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:

ZeitfensterREST-API (/api/v1/brews, …)Actions-API und MCP-Server
Pro Stunde100 Anfragen600 Anfragen
Pro 30 Tage1.000 Anfragen20.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
HeaderBedeutung
X-RateLimit-LimitErlaubte Anfragen im Zeitfenster: das Stundenlimit, oder das 30-Tage-Limit, sobald das aufgebraucht ist
X-RateLimit-RemainingVerbleibende Anfragen: der kleinere Rest aus dieser Stunde und den 30 Tagen
X-RateLimit-ResetUnix-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: 45

Empfehlungen

  1. Antworten zwischenspeichern: Hol dieselben Daten nicht immer wieder ab
  2. Seitenweise abrufen: Hol mit dem Parameter limit nur, was du brauchst (höchstens 100 pro Seite)
  3. Änderungen bündeln: Fasse mehrere Änderungen zusammen, wo es geht
  4. 429 sauber behandeln: Warte Retry-After ab 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');
}

Auf dieser Seite