Rate Limits

Die Sentisnap-API implementiert Rate Limiting, um eine faire Nutzung und Plattformstabilität sicherzustellen.

Limits nach Tarif

Rate-Limit-Header

Jede Antwort enthält Header mit dem aktuellen Status Ihres Rate Limits:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 950
X-RateLimit-Reset: 1704891600
X-RateLimit-Policy: 1000;w=3600

Umgang mit Rate Limits

Wenn Sie das Rate Limit überschreiten, erhalten Sie eine 429 Too Many Requests-Antwort:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please slow down your requests.",
    "details": {
      "limit": 1000,
      "remaining": 0,
      "reset": 1704891600,
      "retry_after": 3600
    }
  }
}

Der Retry-After-Header gibt an, wie viele Sekunden Sie vor dem nächsten Versuch warten sollten.

Empfohlene Vorgehensweisen

• Antworten cachen — Speichern Sie Daten lokal, um API-Aufrufe zu reduzieren
• Webhooks verwenden — Erhalten Sie Echtzeit-Updates anstelle von Polling
• Exponential Backoff implementieren — Warten Sie nach Fehlern länger zwischen den Versuchen
• Anfragen bündeln — Nutzen Sie Paginierung effizient und fordern Sie nur an, was Sie benötigen
• Nutzung überwachen — Beobachten Sie den X-RateLimit-Remaining-Header

Beispiel: Exponential 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') || Math.pow(2, i);
      await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
      continue;
    }

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

Höhere Limits benötigt?

Kontaktieren Sie unser Vertriebsteam unter [email protected], um Enterprise-Tarife mit höheren Rate Limits zu besprechen.