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 Ihr Limit.

Einleitung

Rate Limits begrenzen die Anzahl der API-Anfragen, die Sie innerhalb eines bestimmten Zeitraums stellen können.
Überschreiten Sie das Limit, erhalten Sie eine Fehlermeldung und müssen warten, bis das Zeitfenster zurückgesetzt wird.

Jeder API-Key hat ein eigenes Limit pro Minute und pro Tag. Neue Keys starten mit 60 Anfragen pro Minute und 10.000 Anfragen pro Tag.
Einige Endpunkte, etwa Exporte und der Login, haben zusätzliche, strengere Limits.
Nicht authentifizierte Anfragen sind strenger begrenzt als authentifizierte.
Die API sendet keine Header mit dem verbleibenden Kontingent. Werden Sie gedrosselt, enthält die Antwort einen Retry-After-Header mit der Anzahl Sekunden, die Sie warten müssen.

{
  "detail": "Request was throttled. Expected available in 42 seconds."
}

Die Antwort enthält den Header Retry-After: 42.

Backoff-Strategie: Implementieren Sie ein exponentielles Backoff, wenn Sie einen 429-Fehler erhalten.
Retry-After: Warte vor einem neuen Versuch die im Retry-After-Header genannte Anzahl Sekunden.
Optimierung: Reduziere unnötige API-Anfragen durch Caching und effiziente Nutzung der Endpunkte.