Per iniziare
Tassi di cambio live
L’endpoint
live fornisce accesso immediato ai tassi di cambio attuali su più valute, consentendo calcoli finanziari in tempo reale e monitoraggio del mercato.Conversione tassi di cambio
L’endpoint
convert trasforma importi specifici tra valute utilizzando i tassi di cambio più aggiornati, perfetto per applicazioni finanziarie e piattaforme e-commerce.Simboli valutari disponibili
L’endpoint
symbols fornisce un catalogo completo delle valute supportate con descrizioni dettagliate, facilitando la selezione dinamica e la validazione delle valute nelle applicazioni.Architettura REST
L’API tassi di cambio segue i principi REST, utilizzando URL prevedibili e orientati alle risorse e codici di stato HTTP standard per un’integrazione fluida e una gestione degli errori efficace.Sicurezza HTTPS
Tutte le comunicazioni API sono protette con protocolli di crittografia TLS 1.2 o superiore per garantire integrità e privacy dei dati.Versionamento API
L’API tassi di cambio mantiene la retrocompatibilità tramite il versionamento, operando attualmente sulla versione 1 con miglioramenti futuri pianificati.Autenticazione
La tua chiave API funge da credenziale esclusiva per accedere all’API tassi di cambio. Ogni servizio Cleariflow richiede una chiave univoca, garantendo accesso sicuro e isolato tra le diverse API.Codici di risposta ed errore
Quando le richieste falliscono, l’API restituisce risposte di errore JSON strutturate con codici e descrizioni specifici per una risoluzione efficace dei problemi.| Code | Type | Details |
|---|---|---|
| 200 | OK | Tutto ha funzionato come previsto. |
| 204 | OK | Non ci sono dati di localizzazione per l’IP inviato. |
| 400 | Bad request | Richiesta non valida. |
| 401 | Unauthorized | La richiesta non è stata accettata. Di solito a causa di una chiave API mancante o errata. |
| 422 | Quota reached | La richiesta è stata interrotta per crediti API insufficienti. (Piani gratuiti) |
| 429 | Too many requests | La richiesta è stata interrotta perché è stato raggiunto il numero di richieste consentite al secondo. Succede sui piani gratuiti poiché le richieste sono limitate a 1 al secondo. |
| 500 | Internal server error | La richiesta non è stata completata a causa di un errore lato server. |
| 503 | Service unavailable | Il server non era disponibile. |