Referenz
Ratenbegrenzungen
Auf dieser Seite
Überblick
Die RateFlow API erzwingt zwei Ebenen der Ratenbegrenzung:
- Pro-Minute-Limit: Ein gleitendes Fenster, das begrenzt, wie viele Anfragen Sie innerhalb eines 60-Sekunden-Fensters stellen können.
- 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) |
Limits überschreiten
Wenn Sie Ihr Ratenlimit überschreiten, gibt die API eine 429 Too Many Requests-Antwort zurück:
{
"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
titleunddetailin 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.