Erste Schritte
Live-Wechselkurse
Der
live-Endpunkt bietet sofortigen Zugriff auf aktuelle Wechselkurse für mehrere Währungen — für Echtzeit-Finanzberechnungen und Marktmonitoring.Währungsumrechnung
Der
convert-Endpunkt rechnet bestimmte Beträge zwischen Währungen mit den aktuellsten Wechselkursen um — ideal für Finanzanwendungen und E-Commerce-Plattformen.Verfügbare Währungssymbole
Der
symbols-Endpunkt liefert einen umfassenden Katalog unterstützter Währungen mit detaillierten Beschreibungen für dynamische Währungsauswahl und Validierung in Anwendungen.REST-Architektur
Die Wechselkurs-API folgt REST-Prinzipien mit vorhersehbaren, ressourcenorientierten URLs und standardmäßigen HTTP-Statuscodes für nahtlose Integration und Fehlerbehandlung.HTTPS-Sicherheit
Alle API-Kommunikation wird mit TLS 1.2 oder höher verschlüsselt, um Datenintegrität und Datenschutz zu gewährleisten.API-Versionierung
Die Wechselkurs-API bleibt durch Versionierung abwärtskompatibel und befindet sich derzeit in Version 1 mit geplanten zukünftigen Erweiterungen.Authentifizierung
Ihr API-Schlüssel ist die ausschließliche Berechtigung für den Zugriff auf die Wechselkurs-API. Jeder Cleariflow-Dienst erfordert einen eigenen Schlüssel für sicheren und isolierten Zugriff.Antwort- und Fehlercodes
Bei fehlgeschlagenen Anfragen liefert die API strukturierte JSON-Fehlerantworten mit spezifischen Codes und Beschreibungen zur effektiven Fehlerbehebung.| Code | Typ | Beschreibung |
|---|---|---|
| 200 | OK | Alles funktionierte wie erwartet. |
| 204 | OK | Für die übermittelte IP liegen keine Standortdaten vor. |
| 400 | Bad request | Fehlerhafte Anfrage. |
| 401 | Unauthorized | Die Anfrage war nicht zulässig — in der Regel fehlt der API-Schlüssel oder er ist ungültig. |
| 422 | Quota reached | Die Anfrage wurde abgebrochen, da nicht genügend API-Guthaben vorhanden ist (kostenlose Tarife). |
| 429 | Too many requests | Das Anfragenlimit pro Sekunde wurde erreicht. Bei kostenlosen Tarifen gilt ein Limit von 1 Anfrage pro Sekunde. |
| 500 | Internal server error | Die Anfrage konnte aufgrund eines Serverfehlers nicht abgeschlossen werden. |
| 503 | Service unavailable | Der Server war nicht verfügbar. |