Données sur une devise

Ce endpoint renvoi les données disponibles sur une devise (nom, code, détails sur le symbole, informations sur les séparateurs, etc).

Requête

GET  https://connect.visamundi.io/v3/currency/{id}

Dans cette requête, {id} doit être remplacé par un code de devise suivant la norme ISO 4217 à 3 lettres.

Exemple :

GET  https://connect.visamundi.io/v3/currency/EUR

Paramètres de la requête

Paramètre		Description
access_token	Requis	La clé permettant de vous authentifier auprès de l’API. En savoir plus sur l’authentification
language	Optionnel	En savoir plus sur les langues disponibles

Exemple de réponse

{
    "success": true,
    "statusCode": 200,
    "code": "ok",
    "data": {
        "currency": {
            "name": "Euro",
            "code": "EUR",
            "symbol": {
                "left": "",
                "right": "€",
                "padding": true
            },
            "thousands_separator": ".",
            "decimal_separator": ",",
            "decimals": 2,
            "is_indexed_to_dollar": false,
            "countries": [
                "AND",
                "AUT",
                "BEL",
                "CYP",
                "DEU",
                "ESP",
                "EST",
                "FIN",
                "FRA",
                "GRC",
                [...]
            ]
        }
    }
}

Paramètres de réponse

Dans la réponse, data contient un objet currency avec plusieurs éléments :

Paramètre/Objet	Description
name	Nom de la devise.
code	Code devise à 3 lettres basé sur la norme ISO 4217.
symbol	Symbole détaillé de la devise permettant son formatage (Ex : 100,00 €) – Clé left Partie du symbole se situant à gauche du montant. – Clé right Partie du symbole se situant à droite du montant. – Clé padding Booléen indiquant si les parties gauche et droite sont séparées du montant par un espace.
thousands_separator	Séparateur des milliers.
decimal_separator	Séparateur des décimales.
decimals	Nom de décimales.
is_indexed_to_dollar	Booléen indiquant si la devise est indexée sur le Dollar US.
countries	Codes des pays utilisants cette devise. En savoir plus sur les codes pays

Codes et messages d’erreur

En plus des codes et messages d’erreur de l’API, ce endpoint peut renvoyer d’autres codes et messages :

StatusCode	Code	Description
200	no_currency_found	« No currency found » La requête s’est bien déroulée mais aucune devise n’a été trouvée.