Ratenbegrenzungen

Überblick

Die RateFlow API erzwingt zwei Ebenen der Ratenbegrenzung:

  1. Pro-Minute-Limit — Ein gleitendes Fenster, das begrenzt, wie viele Anfragen Sie innerhalb eines 60-Sekunden-Fensters stellen können.
  2. Monatliches Kontingent — Ein festes monatliches Kontingent, das am 1. jedes Monats (UTC) zurückgesetzt wird.

Beide Limits werden gleichzeitig durchgesetzt. Eine Anfrage muss beide Prüfungen bestehen, um erfolgreich zu sein.

Antwort-Header

Jede erfolgreiche API-Antwort enthält Ratenbegrenzungs-Header:

Header Beschreibung
X-RateLimit-Limit Maximal erlaubte Anfragen pro Minute in Ihrem Plan
X-RateLimit-Remaining Verbleibende Anfragen im aktuellen 60-Sekunden-Fenster
X-RateLimit-Reset Unix-Zeitstempel, wann das aktuelle Pro-Minute-Fenster zurückgesetzt wird
X-Request-ID Eindeutiger Bezeichner für die Anfrage (nützlich für den Support)

Bei Überschreitung des monatlichen Kontingents enthält die Antwort:

Header Beschreibung
Retry-After Anzahl der Sekunden, die vor einem erneuten Versuch gewartet werden soll

Plan-Limits

Plan Anfragen / Monat Pro-Minute-Limit Historischer Zugriff
Kostenlos 2.000 100 Nein
Pro 50.000 1.000 Ja (1 Jahr)
Business 300.000 10.000 Ja (unbegrenzt)

{info} Benötigen Sie höhere Limits? Kontaktieren Sie uns für einen individuellen Enterprise-Plan.

Limits überschreiten

Wenn Sie Ihr Ratenlimit überschreiten, gibt die API eine 429 Too Many Requests-Antwort zurück:

{
    "type": "https://rateflowapi.com/errors/quota-exceeded",
    "title": "Quota Exceeded",
    "status": 429,
    "detail": "You have exceeded your monthly API quota."
}

Hinweis: Die Felder title und detail in API-Fehlerantworten werden derzeit immer auf Englisch zurückgegeben.

Tipps zur Vermeidung von Ratenbegrenzung:

  • Cachen Sie Antworten auf Ihrer Seite (Wechselkurse werden typischerweise einmal pro Tag aktualisiert).
  • Verwenden Sie den /v1/rates/latest?base=EUR-Endpunkt, um alle Kurse in einem Aufruf zu erhalten, anstatt einzelne Paaranfragen zu stellen.
  • Überwachen Sie Ihre Nutzung mit dem Kontingent-Endpunkt oder dem Dashboard.
  • Upgraden Sie Ihren Plan für höhere Limits unter Preise.