开放Api-得到货币列表
接口信息
- 接口地址:
{your-site-url}/manager/api/apps/openapi/base/get-shop-currencys - 基础 URL:
{your-site-url}需替换为你自己的独立站 URL 地址，如https://your-domain.com - 请求方式:
GET - 说明: 此接口通过 OpenAPI 通道获取店铺支持的货币信息，包括默认货币和已开启的货币列表
认证
此接口使用 OpenAPI 通道认证，需要同时携带以下三个请求头：
| Header | 值 | 说明 |
|---|---|---|
open-access-token |
{your-open-access-token} |
OpenAPI 访问令牌 |
请求参数
无需传递请求参数。
请求示例
cURL
curl --location --request GET '{your-site-url}/manager/api/apps/openapi/base/get-shop-currencys' \
--header 'open-access-token: {your-open-access-token}' \
--data-raw ''
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": {
"shop_base_currency_code": "EUR",
"shop_currency_list": [
{
"code": "EUR",
"title": "欧元(EUR)",
"name": "Euro (EUR)",
"symbol": "€",
"flag": "/system/currencys/eur.png",
"currency_symbol_pos": "left"
},
{
"code": "USD",
"title": "美元(USD)",
"name": "United States Dollars (USD)",
"symbol": "$",
"flag": "/system/currencys/usd.png",
"currency_symbol_pos": "left"
}
]
},
"message": "success"
}
返回字段说明
data 顶层字段
| 字段 | 类型 | 说明 |
|---|---|---|
shop_base_currency_code |
string | 店铺的默认货币代码 |
shop_currency_list |
Array[Object] | 店铺支持的货币列表 |
shop_currency_list 子项字段
| 字段 | 类型 | 说明 |
|---|---|---|
code |
string | 货币代码（如 EUR、USD、CNY） |
title |
string | 货币中文标题 |
name |
string | 货币英文名称 |
symbol |
string | 货币符号（如 €、$、¥） |
flag |
string | 货币国旗图标路径 |
currency_symbol_pos |
string | 货币符号位置。left 符号在左侧，right 符号在右侧 |
注意事项
- 此接口为 GET 请求，无需传参
- 返回的货币列表为后台已开启的货币，非系统支持的全部货币
shop_base_currency_code为店铺基准货币，其他货币汇率基于此换算- 认证需携带header
open-access-token