Zum Inhalt springen
RateFlowAPI

Referenz

Ratenbegrenzungen

Auf dieser Seite

Ü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.

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)

Limits überschreiten

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

JSON
{
    "success": false,
    "error": {
        "type": "https://rateflowapi.com/errors/quota-exceeded",
        "code": "QUOTA_EXCEEDED",
        "title": "Monthly Quota Exceeded",
        "status": 429,
        "detail": "You have exceeded your plan's monthly request limit."
    }
}

Wenn Sie stattdessen das Limit pro Minute überschreiten, lautet der Fehlertyp quota-reached mit dem Code QUOTA_REACHED. Alle Fehlercodes finden Sie unter Fehler.

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.