exchange-rates liefert ein Bündel aktueller Wechselkurse, mit dem sich Beträge aus beliebigen bekannten Währungen in eine frei wählbare Zielwährung umrechnen lassen.
Die Kurse basieren auf den von der Europäischen Zentralbank (EZB) bezogenen Referenzkursen. Intern werden diese Kurse relativ zur Basiswährung EUR gespeichert; der Endpunkt berechnet daraus die Kreuzkurse zur angefragten Zielwährung. Genutzt wird die Schnittstelle unter anderem vom Admin Interface, um Beträge lokal in der gewählten Anzeige-Währung darzustellen, ohne dass für jede Umrechnung eine separate Anfrage nötig ist.
Die Wechselkurse werden täglich von der EZB abgerufen. Der Endpunkt liefert dabei stets den aktuellsten dem Shop bekannten Wechselkurs zurück.
Unterstützte Methoden
Angabe aller unterstützten Methoden.Datenfelder eines Kurseintrags
Jeder Eintrag im Objektrates beschreibt den Umrechnungskurs einer Währung in die angefragte Zielwährung.
Die Basiswährung EUR ist immer im Ergebnis enthalten, auch wenn für sie kein eigener Kurssatz in der Datenbank vorliegt. Sie besitzt implizit den Kurs
1.0 mit dem aktuellen Datum.Methoden für Wechselkurse
GET exchange-rates
Mit diesem Endpunkt wird ein Bündel von Umrechnungskursen relativ zu einer Zielwährung abgerufen. Die Zielwährung wird über den Pflichtparametertarget als dreistelliger ISO-4217-Währungscode (z. B. EUR, USD, GBP) übergeben. Die Antwort enthält für jede im System bekannte Währung einen Kurseintrag sowie zusätzlich die Zielwährung selbst (mit Kurs 1.0).
Beispiel
Unterstützte Parameter
Antwort
1 USD etwa 0,92 EUR und 1 GBP etwa 1,18 EUR. Um einen Betrag umzurechnen, wird er mit dem rate der Ausgangswährung multipliziert.