Referenz
Fehlerbehandlung
Auf dieser Seite
Fehlerformat
Wenn die API eine Anfrage ablehnt, gibt sie "success": false und ein error-Objekt zurück. Das error-Objekt basiert auf dem RFC 7807 Problem Details-Format und enthält zusätzlich einen maschinenlesbaren code. Die Antwort hat den Header Content-Type: application/problem+json.
{
"success": false,
"error": {
"type": "https://rateflowapi.com/errors/invalid-api-key",
"code": "INVALID_API_KEY",
"title": "Invalid API Key",
"status": 401,
"detail": "The API key provided is missing or invalid."
}
}
| Feld | Beschreibung |
|---|---|
success |
Bei einem Fehler immer false |
error.type |
Eine URI, die den Fehlertyp identifiziert |
error.code |
Ein stabiler, maschinenlesbarer Code in UPPER_SNAKE_CASE. Verwenden Sie dieses Feld in Ihrer Fehlerbehandlung |
error.title |
Eine kurze menschenlesbare Zusammenfassung |
error.status |
Der HTTP-Statuscode |
error.detail |
Eine detaillierte Erklärung dieses konkreten Fehlers |
Fehlercodes
| Fehlertyp | Code | HTTP-Status | Beschreibung |
|---|---|---|---|
invalid-api-key |
INVALID_API_KEY |
401 | API-Schlüssel fehlt oder ist ungültig |
inactive-account |
INACTIVE_ACCOUNT |
403 | Konto ist gesperrt, API-Schlüssel ist deaktiviert oder E-Mail ist nicht verifiziert |
plan-upgrade-required |
PLAN_UPGRADE_REQUIRED |
403 | Die angeforderte Funktion ist in Ihrem aktuellen Plan nicht verfügbar (z.B. historische Daten im kostenlosen Plan) |
unsupported-currency |
UNSUPPORTED_CURRENCY |
422 | Der Währungscode wird nicht erkannt |
invalid-date |
INVALID_DATE |
422 | Das Datumsformat ist ungültig oder das Datum liegt in der Zukunft |
invalid-amount |
INVALID_AMOUNT |
422 | Der Betrag ist keine Zahl, oder er ist nicht größer als 0 und höchstens 1.000.000.000.000 |
no-data-available |
NO_DATA_AVAILABLE |
404 | Keine Wechselkursdaten für das angeforderte Datum oder Währungspaar verfügbar |
quota-reached |
QUOTA_REACHED |
429 | Das Limit pro Minute wurde erreicht. Enthält einen Retry-After-Header |
quota-exceeded |
QUOTA_EXCEEDED |
429 | Das monatliche Kontingent ist aufgebraucht. Enthält einen Retry-After-Header |
service-unavailable |
SERVICE_UNAVAILABLE |
503 | Die API ist wegen Wartungsarbeiten vorübergehend nicht verfügbar. Enthält einen Retry-After-Header |