Getting Started

Rate Limits

API-Anfragelimits verstehen und wie man damit umgeht

Rate Limits

Die Blitz Rocket API setzt Rate Limits durch, um eine faire Nutzung sicherzustellen und die Stabilität des Dienstes zu schützen. Die Rate Limits werden pro API-Schlüssel angewendet und variieren je nach Endpunkt.

Standardlimits

EndpunktkategorieLimitZeitraum
Allgemeine Endpunkte100 Anfragen1 Minute
Erstellung von Wettbewerbseinträgen5 Anfragen15 Minuten (pro IP + Wettbewerb)
E-Mail-/Telefonverifizierung10 Anfragen15 Minuten (pro IP + E-Mail)
Eintragsabfrage20 Anfragen5 Minuten (pro IP)

Rate Limit Header

Wenn Sie sich den Rate Limits nähern oder diese überschreiten, gibt die API einen Statuscode 429 Too Many Requests zurück:

json
{
  "success": false,
  "error": "Rate limit exceeded. Please try again later."
}

Best Practices

  • Antworten zwischenspeichern, wo möglich, um die Anzahl der API-Aufrufe zu reduzieren
  • Exponentielles Backoff implementieren, wenn Sie eine 429-Antwort erhalten
  • Operationen bündeln, anstatt viele einzelne Anfragen zu stellen
  • Webhooks verwenden für Echtzeit-Updates anstelle von Polling der Endpunkte

Beispiel: Exponentielles Backoff

javascript
async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, options);

    if (response.status === 429) {
      const delay = Math.pow(2, attempt) * 1000;
      await new Promise((resolve) => setTimeout(resolve, delay));
      continue;
    }

    return response;
  }
  throw new Error("Max retries exceeded");
}