エンドポイント
ローカリゼーションデータを取得
GET | https://api.iglobalstores.com/2.0/localizationExchange - 国レベルの情報に加えて、現地通貨と為替rateの詳細を含むローカリゼーションデータを取得します。
HTTPSリクエスト
| フィールド | ノート |
|---|---|
| HTTPメソッド | GET |
| エンドポイントURL | https://test-api.iglobalstores.com/2.0/localizationExchange |
| プロトコル | HTTPS |
| メッセージフォーマット | JSON |
| Accept HTTPヘッダー | Accept: application/json |
| セキュリティトークンHTTPヘッダー | serviceToken: your-test-token-valueHTTPSリクエストにserviceTokenという名前のヘッダーを追加し、テストセキュリティAPIトークンの値を設定します。（このトークンについてはアカウントマネージャーにお問い合わせください。） |
URLリクエストパラメータ
| フィールド | ノート |
|---|---|
countryCode | 便利のために国固有のマップに保存されている2文字の国コード; また、国固有のマップを取得するために使用されるキーとしても保存されています。例: CA または AU |
format (推奨) | フォーマット情報を返すかどうかを示す真偽値。 |
HTTPSレスポンス
メッセージフォーマット: JSON
例のレスポンス（カナダのみ）
1
2
3
4
5
6
7
8
9
10
11
12
{
"CA": {
"code": "CA",
"currency": "CAD",
"currencySymbol": "$",
"decimalDelimiter": ".",
"name": "Canada",
"rateEstimate": "1.42813",
"scale": "2",
"thousandsDelimiter": ","
}
}
レスポンスJSON定義
| フィールド | ノート |
|---|---|
country | これは、2文字の国コードがキーとなり、特定の国の名前、コード、および通貨コードを含むマップが値となるマップです。 |
country[country_code].code | 特定の国の国固有のマップ内に保存されている2文字の国コードで、利便性のために保存されており、国固有のマップを取得するために使用されるキーとしても保存されています。例: CA または AU |
country[country_code].currency | この国で使用する2文字の通貨コードです。一部の国では、通貨の価値が劇的に変動するため、USDを使用するのが最適です。例: CAD または AUD または USD |
country[country_code].currencySymbol | ブラウザでその通貨を識別するために使用されるシンボルです。 |
country[country_code].decimalDelimiter | formatクエリパラメータがtrueの場合のみ表示され、通貨の小数点に使用される文字を示します。 |
country[country_code].rateEstimate | USDを特定の通貨に変換するために掛け算するrateです。顧客にUSDで請求するが、価格をその外国通貨にローカライズして表示する場合にこのrateを使用します。例えば、10 USDに1.0312（CADに対して与えられたrate）を掛けると、10.31 CAD（“半分上”方式を使用して四捨五入されたCADの価格）になります。例: 1.0312 または 0.8501（レートは最大6桁の精度を含む場合があります、すなわち1.123456）。 |
country[country_code].thousandDelimiter | formatクエリパラメータがtrueの場合のみ表示され、通貨の千/百万/十億の区切りを示す文字を示します。 |
format (推奨) | フォーマット情報を返すかどうかを示す真または偽の値です。 |
ローカリゼーションエクスチェンジAPIレガシー
レガシーローカリゼーションエクスチェンジAPIの動作を学びましょう。
ローカリゼーションエクスチェンジAPIは、国の特性、通貨、為替レートを含むローカリゼーションデータを返します。