Premiers pas
Taux de change en direct
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é.Conversion de taux de change
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.Symboles de devises disponibles
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.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. |