Währungsumrechnung

GET

convert

Währungsumrechnung

curl --request GET \
  --url https://exchange-rates.cleariflow.com/v1/convert

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://exchange-rates.cleariflow.com/v1/convert",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://exchange-rates.cleariflow.com/v1/convert"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://exchange-rates.cleariflow.com/v1/convert")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
    "base": "EUR",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

Erste Schritte

Basis-URL

https://exchange-rates.cleariflow.com/v1/convert

Validierungs-Endpunkt

Der convert-Endpunkt benötigt Ihren API-Schlüssel, eine Basiswährung und einen Zielparameter für Währungsumrechnungen.

https://exchange-rates.cleariflow.com/v1/convert
? api_key = YOUR_UNIQUE_API_KEY
& base = EUR
& target = USD

Diese erfolgreiche Anfrage rechnet 1 EUR in USD mit dem aktuellsten Wechselkurs um:

{
    "base": "EUR",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

Anfrageparameter

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.

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.

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.

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.

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.

String

Die Basiswährung, für die die Wechselkurse abgerufen wurden.

String

Die Zielwährung, in die der base_amount umgerechnet wurde.

String

Das Datum, von dem die Währungskurse gemäß der erfolgreichen Anfrage stammen.

Float

Der Betrag der Basiswährung aus der Anfrage.

Float

Der Betrag in der Zielwährung, in den der base_amount umgerechnet wurde.

Float

Der Wechselkurs, mit dem der base_amount von der Basiswährung in die Zielwährung umgerechnet wurde.

Währungsumrechnung

curl --request GET \
  --url https://exchange-rates.cleariflow.com/v1/convert

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://exchange-rates.cleariflow.com/v1/convert",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://exchange-rates.cleariflow.com/v1/convert"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://exchange-rates.cleariflow.com/v1/convert")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
    "base": "EUR",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

Validierung

Abfrage

Erstellung

Erste Schritte

Basis-URL

Validierungs-Endpunkt

Anfrageparameter

Antwortparameter

​Erste Schritte

​Basis-URL

​Validierungs-Endpunkt

​Anfrageparameter

​Antwortparameter

Erste Schritte

Basis-URL

Validierungs-Endpunkt

Anfrageparameter

Antwortparameter