Partager via

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

Pour open RTB côté achat pour les soumissionnaires, vous pouvez envoyer des devises autres que USD dans la demande d’offre sortante aux soumissionnaires et accepter d’autres devises dans la réponse. Pour qu’un soumissionnaire change la devise de sa soumission, il doit envoyer le "cur" champ. Si le "cur" champ n’est pas spécifié, il est défini par défaut sur USD. Un soumissionnaire peut répondre avec n’importe quelle devise, quelle que soit la valeur définie dans la devise par défaut. Ils doivent simplement indiquer la devise dans le "cur" champ et aucune activation supplémentaire n’est requise.

Pour open RTB côté vente, par défaut, l’USD est utilisé comme devise où le "cur" champ est ignoré. Si le membre vendeur dispose d’un droit de membre pour seller_bid_currency une configuration explicite, le "cur" champ dans les demandes d’enchères est respecté.

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

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é

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 truela 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 string Symbole de la devise, par exemple , pour$" l’USD

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.

Remarque

*Lors de l’interrogation de l’API monétaire (par exemple), rate_per_usdle service retourne actuellement toutes les valeurs correctes, à l’exception de last_modified. Les taux réels sont exacts et l’API retourne des taux de change mis à jour. Actuellement, 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.adnxs.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
            }
                        ...
        ],
        "count": 17,
        "start_element": null,
        "num_elements": null
    }
}

Afficher le taux de change de l’EUR au 1er mars 2020

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