端点
检索本地化数据
GET | https://api.iglobalstores.com/2.0/localizationExchange
- 检索包含国家级信息以及本地货币和汇率rate详细信息的本地化数据。
HTTPS请求
字段 | 备注 |
---|---|
HTTP方法 | GET |
端点URL | https://test-api.iglobalstores.com/2.0/localizationExchange |
协议 | HTTPS |
消息格式 | JSON |
接受HTTP头 | Accept: application/json |
安全令牌HTTP头 | serviceToken : your-test-token-value在您的HTTPS请求中添加一个名为serviceToken的头,值为您的测试安全API令牌。(请联系您的客户经理以获取此令牌。) |
URL请求参数
字段 | 备注 |
---|---|
countryCode | 给定国家的两字符国家代码,方便存储在特定国家的地图中;也作为用于检索特定国家地图的键。示例值: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 | 这是一个映射,键为两字符国家代码,值为包含特定国家名称、代码和货币代码的映射。 |
country[country_code].code | 给定国家的两字符国家代码,存储在国家特定映射中以方便使用;也作为用于检索国家特定映射的键。示例值:CA 或 AU |
country[country_code].currency | 用于该国家的两字符货币代码。对于某些国家,最好使用 USD,因为它们的货币价值波动过大。示例值:CAD 或 AUD 或 USD |
country[country_code].currencySymbol | 用于在浏览器中识别该货币的符号。 |
country[country_code].decimalDelimiter | 仅在格式查询参数为真时出现;显示用于货币的小数点的字符。 |
country[country_code].rateEstimate | rate 用于将 USD 转换为特定货币的估算外币定价的乘数。当您打算以 USD 向客户收费但显示本地化的外币价格时,您将使用此 rate。例如,10 USD 乘以 1.0312(为 CAD 提供的 rate)= 10.31 CAD(使用“向上取整”方法四舍五入的 CAD 价格)。示例值:1.0312 或 0.8501(汇率最多可包含 6 位精度,即 1.123456。) |
country[country_code].thousandDelimiter | 仅在格式查询参数为真时出现。显示表示千/百万/十亿标记之间分隔的字符。 |
format (推荐) | 真或假值,用于指示是否返回格式信息。 |
遗留本地化交换API
了解遗留本地化交换API的工作原理。本地化交换API返回包含国家特定信息、货币和汇率的本地化数据。