Rate Limits und API-Kontingente verstehen

Was sind Rate Limits?

Rate Limits begrenzen die Anzahl der API-Anfragen pro Zeitfenster, um die Stabilität der Plattform zu gewährleisten und Missbrauch zu verhindern.

Standardlimits

• Öffentliche Endpunkte: 100 Anfragen/Minute
• Authentifizierte Endpunkte: 1.000 Anfragen/Minute
• Schreiboperationen (POST/PUT/DELETE): 100 Anfragen/Minute
• Bild-Upload: 20 Uploads/Minute

HTTP-Antwort bei Überschreitung

Bei Überschreitung des Limits gibt die API HTTP 429 Too Many Requests zurück mit folgendem Body:

{
  "error": "rate_limit_exceeded",
  "retry_after": 42,
  "limit": 1000,
  "remaining": 0
}

retry_after gibt an, nach wie vielen Sekunden erneute Anfragen möglich sind.

Best Practices

• Implementiere exponentielles Backoff bei 429-Fehlern
• Nutze den Header X-RateLimit-Remaining zur proaktiven Steuerung
• Bündele Anfragen wo möglich (Batch-Endpunkte)