Digital Platform API - Currency サービス

  • [アーティクル]

警告

API Currency Service は、Xandr プラットフォームを介した取引の結果として支払われた金額または受け取った金額を調整するためだけにクライアントが利用でき、クライアントが他の目的で使用することはできません。

これは、使用する行項目または挿入順序を設定できる通貨の一覧を示す読み取り専用サービスです。

REST API

HTTP メソッド エンドポイント 説明
GET https://api.appnexus.com/currency 使用可能なすべての通貨を表示する
GET https://api.appnexus.com/currency?code=CURRENCY_CODE 特定の通貨を表示する
GET https://api.appnexus.com/currency?code=CURRENCY_CODE&show_rate=true 今日の通貨の為替レートを表示する
GET https://api.appnexus.com/currency?show_rate=true&code=CURRENCY_CODE&ymd=2012-03-01 過去 1 日の通貨の為替レートを表示する

注:

為替レートは、Oanda から毎日午前 3 時 (UTC) に 1回提供されます。

JSON フィールド

フィールド 型 説明
as_of string Oanda が最後に UTC で為替レートを更新した日時。 Oanda から毎日午前 3 時 (UTC) に料金を引き出します。 これは、クエリ文字列を渡 show_rate=true す場合にのみ返されます。
code string 通貨のコード。
description string 通貨の説明。
is_exposed ブール値 の場合 true、通貨が公開されます。
last_modified string 通貨が最後に変更された日時。 ( 注 *) を参照してください。
name string 通貨の完全な名前。
position 列挙 通貨記号が金額の前後に表示されるかどうか。 使用可能な値: "before" または "after"。
rate_per_usd double 為替レート。 これは、クエリ文字列を渡 show_rate=true す場合にのみ返されます。
symbol string 通貨の記号 (USD など) "$"

注:

  • コンバージョン率を表示するには、URL を渡します show_rate=true 。 URL を使用して渡 ymd=YYYYMMDD すことで、過去 1 日のレートを取得することもできます。

  • * 通貨 API (例: rate_per_usd) に対してクエリを実行すると、サービスはすべての正しい値を返しますが、 は例外 last_modifiedです。 実際のレートは正確であり、API は更新された為替レートを返します。

の代わりに last_modified 列をas_of使用して、返される為替レートのバージョンを把握します。

例

使用可能なすべての通貨を表示する

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
    }
}

2024 年 1 月 2 日の EUR 為替レートを表示する

$ 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
    }
}