Vai al contenuto principale
GET
/
v1
/
convert
Conversione valutaria
curl --request GET \
  --url https://exchange-rates.cleariflow.com/v1/convert
{
    "base": "EUR",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

​
Per iniziare

​
URL di base

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

​
Endpoint di validazione

L’endpoint convert richiede la tua chiave API, una valuta di base e un parametro target per eseguire conversioni valutarie. 
https://exchange-rates.cleariflow.com/v1/convert
? api_key = YOUR_UNIQUE_API_KEY
& base = EUR
& target = USD
Questa richiesta riuscita converte 1 EUR in USD utilizzando il tasso di cambio più aggiornato: 
{
    "base": "EUR",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

​
Parametri della richiesta

​
api_key
String
obbligatorio
La tua chiave API univoca. Nota che ogni utente ha chiavi API univoche per ciascuna delle API Cleariflow, quindi la chiave dell’API tassi di cambio non funzionerà per l’API di geolocalizzazione IP, ad esempio.
​
base
String
obbligatorio
La valuta di base usata per ottenere l’ultimo/i tasso/i di cambio. Usa lo standard valutario ISO 4217 (es. USD per dollari statunitensi), come tutti i parametri valuta in questa API.
​
target
String
obbligatorio
La valuta o le valute di destinazione per ottenere il tasso di cambio rispetto alla valuta di base. Come i parametri base, qualsiasi valuta passata qui segue lo standard ISO 4217. Nota che, a differenza degli altri endpoint, convert accetta solo una valuta di destinazione alla volta.
​
date
String
La data storica da cui desideri ottenere i tassi, nel formato YYYY-MM-DD. Se lasci vuoto, verranno usati gli ultimi tassi disponibili.
​
base_amount
Float
L’importo della valuta di base che desideri convertire nella valuta di destinazione.

​
Parametri della risposta

La risposta API viene restituita in un formato JSON universale e leggero.
​
base
String
La valuta di base usata per ottenere i tassi di cambio.
​
target
String
La valuta di destinazione in cui è stato convertito base_amount.
​
date
String
La data da cui sono stati estratti i tassi, secondo la richiesta riuscita.
​
base_amount
Float
L’importo della valuta di base dalla richiesta.
​
converted_amount
Float
L’importo della valuta di destinazione in cui base_amount è stato convertito.
​
exchange_rate
Float
Il tasso di cambio usato per convertire base_amount dalla valuta di base alla valuta di destinazione.