> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Introduzione
> L'API tassi di cambio di Cleariflow offre capacità di conversione valutaria in tempo reale tramite un'interfaccia RESTful JSON snella e moderna, con supporto per oltre 80 valute globali, tassi live, dati storici e strumenti di conversione istantanea.
## Per iniziare
L'endpoint `live` fornisce accesso immediato ai tassi di cambio attuali su più valute, consentendo calcoli finanziari in tempo reale e monitoraggio del mercato.
L'endpoint `convert` trasforma importi specifici tra valute utilizzando i tassi di cambio più aggiornati, perfetto per applicazioni finanziarie e piattaforme e-commerce.
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. |