Zum Hauptinhalt springen
GET
Währungsumrechnung

Erste Schritte

Basis-URL

Validierungs-Endpunkt

Der convert-Endpunkt benötigt Ihren API-Schlüssel, eine Basiswährung und einen Zielparameter für Währungsumrechnungen.
Diese erfolgreiche Anfrage rechnet 1 EUR in USD mit dem aktuellsten Wechselkurs um:

Anfrageparameter

api_key
String
erforderlich
Ihr eindeutiger API-Schlüssel. Beachten Sie, dass jeder Nutzer für jede Cleariflow-API eigene API-Schlüssel hat — Ihr Wechselkurs-API-Schlüssel funktioniert z. B. nicht für die IP-Geolokalisierungs-API.
base
String
erforderlich
Die Basiswährung, für die die aktuellen Wechselkurse abgerufen werden sollen. Verwendet den ISO-4217-Währungsstandard (z. B. USD für US-Dollar), wie alle Währungsparameter in dieser API.
target
String
erforderlich
Die Zielwährung, für die der Wechselkurs gegenüber der Basiswährung ermittelt werden soll. Wie beim base-Parameter folgen alle hier übergebenen Währungen dem ISO-4217-Standard. Beachten Sie, dass convert im Gegensatz zu den anderen Endpunkten nur eine Zielwährung gleichzeitig akzeptiert.
date
String
Das historische Datum, von dem Kurse abgerufen werden sollen, im Format JJJJ-MM-TT. Bleibt der Parameter leer, werden die aktuell verfügbaren Kurse verwendet.
base_amount
Float
Der Betrag der Basiswährung, der in die Zielwährung umgerechnet werden soll.

Antwortparameter

Die API-Antwort wird in einem universellen und leichtgewichtigen JSON-Format zurückgegeben.
base
String
Die Basiswährung, für die die Wechselkurse abgerufen wurden.
target
String
Die Zielwährung, in die der base_amount umgerechnet wurde.
date
String
Das Datum, von dem die Währungskurse gemäß der erfolgreichen Anfrage stammen.
base_amount
Float
Der Betrag der Basiswährung aus der Anfrage.
converted_amount
Float
Der Betrag in der Zielwährung, in den der base_amount umgerechnet wurde.
exchange_rate
Float
Der Wechselkurs, mit dem der base_amount von der Basiswährung in die Zielwährung umgerechnet wurde.