Ratenbegrenzungen

Phase 2

Diese Dokumentation ist eine Vorschau. Die API befindet sich derzeit in der Entwicklung.

Standardlimits

Plan	Anfragen pro Minute	Anfragen pro Tag
Standard	60	10.000
Enterprise	300	100.000

Header für Ratenbegrenzungen

Jede API-Antwort enthält Informationen zur Ratenbegrenzung in den Headern:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1679000000

Header	Beschreibung
X-RateLimit-Limit	Maximal erlaubte Anfragen im aktuellen Zeitfenster
X-RateLimit-Remaining	Verbleibende Anfragen im aktuellen Zeitfenster
X-RateLimit-Reset	Unix-Zeitstempel, wann die Ratenbegrenzung zurückgesetzt wird

Limits überschreiten

Wenn Sie die Ratenbegrenzung überschreiten, erhalten Sie eine 429 Too Many Requests-Antwort:

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Retry after 30 seconds.",
    "retry_after": 30
  }
}

Bewährte Vorgehensweisen

• Antworten zwischenspeichern, wenn sich Daten nicht häufig ändern (Standorte, Profile)
• Webhooks verwenden für Echtzeitdaten anstatt die API abzufragen
• Stapelverarbeitung nutzen, wo die API dies unterstützt
• Exponentielles Backoff implementieren für Wiederholungsversuche bei Ratenbegrenzung
• Ihre Nutzung überwachen über die Header für Ratenbegrenzungen