> ## 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.

# Introduction

> L'API de taux de change Cleariflow offre des capacités de conversion de devises en temps réel via une interface JSON RESTful moderne et rationalisée, prenant en charge plus de 80 devises mondiales.

## Premiers pas

<Card title="Taux de change en direct" icon="activity" href="exchange-rates/live">
  L'endpoint `live` fournit un accès instantané aux taux de change actuels pour plusieurs devises, permettant des calculs financiers en temps réel et le suivi du marché.
</Card>

<Card title="Conversion de taux de change" icon="arrow-left-right" href="exchange-rates/convert">
  L'endpoint `convert` transforme des montants spécifiques entre devises à l'aide des taux de change les plus récents, parfait pour les applications financières et les plateformes e-commerce.
</Card>

<Card title="Symboles de devises disponibles" icon="circle-dollar-sign" href="exchange-rates/symbols">
  L'endpoint `symbols` fournit un catalogue complet des devises prises en charge avec des descriptions détaillées, facilitant la sélection dynamique et la validation des devises dans les applications.
</Card>

### Architecture REST

L'API de taux de change suit les principes REST, en utilisant des URL prévisibles orientées ressources et des codes de statut HTTP standard pour une intégration fluide et la gestion des erreurs.

### Sécurité HTTPS

Toutes les communications API sont sécurisées à l'aide de protocoles de chiffrement TLS 1.2 ou supérieur pour garantir l'intégrité et la confidentialité des données.

### Versionnage de l'API

L'API de taux de change maintient la rétrocompatibilité par le versionnage, fonctionnant actuellement en version 1 avec des améliorations futures prévues.

### Authentification

Votre clé API sert d'identifiant exclusif pour accéder à l'API de taux de change. Chaque service Cleariflow nécessite une clé unique, garantissant un accès sécurisé et isolé entre les différentes API.

## Codes de réponse et d'erreur

Lorsque les requêtes échouent, l'API renvoie des réponses d'erreur JSON structurées avec des codes et descriptions spécifiques pour un dépannage efficace.

| Code | Type                  | Détails                                                                                                                                                          |
| ---- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200  | OK                    | Tout a fonctionné comme prévu.                                                                                                                                   |
| 204  | OK                    | Il n'y a pas de données de localisation pour l'IP soumise.                                                                                                       |
| 400  | Bad request           | Mauvaise requête.                                                                                                                                                |
| 401  | Unauthorized          | La requête était inacceptable. Généralement due à une clé API manquante ou incorrecte.                                                                           |
| 422  | Quota reached         | La requête a été interrompue en raison de crédits API insuffisants. (Forfaits gratuits)                                                                          |
| 429  | Too many requests     | La requête a été interrompue car le nombre de requêtes autorisées par seconde a été atteint. Cela se produit sur les forfaits gratuits, limités à 1 par seconde. |
| 500  | Internal server error | La requête n'a pas pu être complétée en raison d'une erreur côté serveur.                                                                                        |
| 503  | Service unavailable   | Le serveur était indisponible.                                                                                                                                   |