Ratenlimits

BatteryPass begrenzt Anfragen, um die Plattform und die anderen Organisationen darauf zu schützen. Eine Anfrage über einem Limit wird mit 429 rate_limited und einem Header Retry-After beantwortet.

LimitsLink zum Abschnitt kopieren

Die Zeitfenster sind fest: Ein Fenster beginnt, zählt hoch und wird an seinem Ende zurückgesetzt. Alle Schlüssel einer Organisation teilen sich die 600 Anfragen; weitere Schlüssel erhöhen das Limit nicht.

Die Antwort 429Link zum Abschnitt kopieren

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 17
X-Request-Id: 8b1e6f03c2d94a7e5f0a1b2c

{
  "type": "about:blank",
  "title": "Too Many Requests",
  "status": 429,
  "code": "rate_limited",
  "detail": "Too many attempts. Try again later.",
  "request_id": "8b1e6f03c2d94a7e5f0a1b2c"
}

Retry-After ist die Zahl der Sekunden bis zum Ende des aktuellen Zeitfensters. Eine mit 429 beantwortete Anfrage wurde nicht ausgeführt; Sie können sie nach der Wartezeit wiederholen, auch Schreibzugriffe.

Zurückhaltend wiederholenLink zum Abschnitt kopieren

Warten Sie mindestens Retry-After Sekunden, fügen Sie etwas zufällige Streuung hinzu, damit parallele Worker nicht alle im selben Moment starten, und geben Sie nach einigen Versuchen auf:

const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));

// Wiederholt eine Anfrage nach 429-Antworten und wartet so lange, wie Retry-After sagt.
async function fetchWithBackoff(url: string, init: RequestInit = {}, attempts = 5): Promise<Response> {
  for (let attempt = 1; ; attempt++) {
    const res = await fetch(url, init);
    if (res.status !== 429 || attempt === attempts) return res;
    const seconds = Number(res.headers.get('Retry-After')) || 2 ** attempt;
    await sleep(seconds * 1000 + Math.random() * 1000);
  }
}

const res = await fetchWithBackoff(`${process.env.BATTERYPASS_URL}/api/v1/battery-models`, {
  headers: { Authorization: `Bearer ${process.env.BATTERYPASS_API_KEY}` },
});
console.log(res.status);

Unter den Limits bleibenLink zum Abschnitt kopieren

• Das Budget teilen. Alle Systeme Ihrer Organisation schöpfen aus denselben 600 Anfragen pro Minute. Geben Sie jedem Job einen Anteil, etwa indem Sie eine nächtliche Synchronisation auf wenige Anfragen pro Sekunde drosseln.
• In Seiten zu 200 lesen. Eine Seite von listBatteries ersetzt 200 Einzelabrufe; siehe Paginierung.
• Für Massendaten Exporte nutzen. exportUnits liefert bis zu 10 000 Einheiten mit ihren Werten auf Einheitenebene als eine Tabelle (XLSX oder CSV).
• 401 nicht wiederholen. Korrigieren Sie stattdessen den Schlüssel; fehlgeschlagene Versuche zählen auf die 30 pro 15 Minuten.
• Öffentliche Abrufe zwischenspeichern. Öffentliche Pässe werden fünf Minuten zwischengespeichert; häufigeres Lesen desselben Passes bringt nichts.

Wenn Ihre Integration mehr braucht, als diese Limits erlauben, wenden Sie sich an den Support.