API de plateforme numérique - Service monétaire

Avertissement

Le service de devise de l’API est disponible pour les clients uniquement pour rapprocher les montants payés ou reçus par eux à la suite de leurs transactions via la plateforme Xandr et ne peut pas être utilisé par les clients à d’autres fins.

Il s’agit d’un service en lecture seule qui affiche la liste des devises que vous pouvez définir un élément de ligne ou un ordre d’insertion à utiliser.

API REST

HTTP, méthode	Endpoint	Description
`GET`	`https://api.appnexus.com/currency`	Afficher toutes les devises disponibles
`GET`	`https://api.appnexus.com/currency?code=CURRENCY_CODE`	Afficher une devise spécifique
`GET`	`https://api.appnexus.com/currency?code=CURRENCY_CODE&show_rate=true`	Afficher le taux de change d’une devise pour aujourd’hui
`GET`	`https://api.appnexus.com/currency?show_rate=true&code=CURRENCY_CODE&ymd=2012-03-01`	Afficher le taux de change d’une devise pour un jour passé

Remarque

Les taux de change proviennent une fois par jourd’Oanda vers 3h00 UTC.

Champs JSON

Champs	Type	Description
`as_of`	string	Date et heure auxquelles Oanda a mis à jour pour la dernière fois le taux de change au format UTC. Nous tirons les tarifs d’Oanda tous les jours à 3h00 UTC. Cette valeur est retournée uniquement lorsque vous transmettez `show_rate=true` la chaîne de requête.
`code`	string	Code de la devise.
`description`	string	Description de la devise.
`is_exposed`	valeur booléenne	Si `true`la valeur est , la devise est exposée.
`last_modified`	chaîne	Date et heure de la dernière modification de la devise. (Voir remarque *)
`name`	string	Nom complet de la devise.
`position`	enum	Indique si le symbole monétaire apparaît avant ou après le montant. Valeurs possibles : `"before"` ou `"after"`.
`rate_per_usd`	double	Taux de change. Cette valeur est retournée uniquement lorsque vous transmettez `show_rate=true` la chaîne de requête.
`symbol`	chaîne	Symbole de la devise, par exemple `"$"` pour l’USD

Remarque

Pour afficher les taux de conversion, transmettez show_rate=true l’URL. Vous pouvez également récupérer le taux d’un jour passé en ymd=YYYYMMDD passant via l’URL.
* Lors de l’interrogation de l’API monétaire (par exemple), rate_per_usdle service retourne toutes les valeurs correctes, à l’exception de last_modified. Les taux réels sont exacts et l’API retourne les taux de change mis à jour.

Utilisez la as_of colonne au lieu de last_modified pour connaître la version du taux de change retourné.

Exemples

Afficher toutes les devises disponibles

curl -b cookies -c cookies 'https://api.appnexus.com/currency'
{
    "response": {
        "status": "OK",
        "currencies": [
            {
                "code": "ARS",
                "symbol": "₱",
                "name": "Argentine Peso (ARS)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-16 23:07:23",
                "is_exposed": true
            },
            {
                "code": "AUD",
                "symbol": "AUD$",
                "name": "Australian Dollar (AUD)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-24 19:29:04",
                "is_exposed": true
            },
            {
                "code": "BRL",
                "symbol": "R$",
                "name": "Brazilian Real (BRL)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-16 23:07:23",
                "is_exposed": true
            },
            {
                "code": "CAD",
                "symbol": "CDN$",
                "name": "Canadian Dollar (CAD)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-24 19:29:04",
                "is_exposed": true
            },
            {
                "code": "CNY",
                "symbol": "元",
                "name": "Chinese Yuan (CNY)",
                "description": null,
                "position": "before",
                "last_modified": "2010-08-16 23:07:23",
                "is_exposed": true
            },
                        ...
        ],
        "count": 17,
        "start_element": null,
        "num_elements": null
    }
}

Afficher le taux de change de l’EUR au 2 janvier 2024

$ curl -b cookies -c cookies  'https://api.appnexus.com/currency?show_rate=true&code=EUR&ymd=2012-03-01'
{
    "response": {
        "status": "OK",
        "currency": {
            "code": "EUR",
            "symbol": "€",
            "name": "Euro (EUR)",
            "description": null,
            "position": "before",
            "last_modified": "2010-08-16 23:07:23",
            "rate_per_usd": 0.7506,
            "as_of": "2024-01-02 11:24:00",
            "is_exposed": true
        },
        "count": 1,
        "start_element": null,
        "num_elements": null
    }
}

Last updated on 2025-04-02

Partager via