Rate Limits

Firmium schützt seine API durch Rate-Limiting, um eine faire Nutzung und Systemstabilität zu gewährleisten. Jede API-Anfrage zählt gegen dein Limit.

Einleitung

  • Rate Limits begrenzen die Anzahl der API-Anfragen, die du innerhalb eines bestimmten Zeitraums stellen kannst.
  • Überschreitest du das Limit, erhältst du eine Fehlermeldung und musst warten, bis das Zeitfenster zurückgesetzt wird.

Limits

  • Standard-Limit für authentifizierte Nutzer: 100 Anfragen pro Minute (je nach Tarif kann das Limit abweichen).
  • Die aktuellen Limits werden im X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset Header jeder Antwort mitgeteilt.

Beispiel für Rate-Limit-Header

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 12
X-RateLimit-Reset: 1712345678

Fehlermeldungen

429 Zu viele Anfragen

{
  "error": "Rate limit exceeded. Please try again later.",
  "limit": 100,
  "reset_in": 42,
  "reset_at": "12:34:56"
}

Best Practices

  1. Backoff-Strategie: Implementiere ein exponentielles Backoff, wenn du einen 429-Fehler erhältst.
  2. Monitoring: Überwache die Rate-Limit-Header, um dein Nutzungsverhalten anzupassen.
  3. Optimierung: Reduziere unnötige API-Anfragen durch Caching und effiziente Nutzung der Endpunkte.

Verwandte Themen


Letzte Aktualisierung am 16.07.2025