Zum Inhalt springen
RateFlowAPI

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.

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