系统-基本设置-保存货币
系统设置-设置默认货币
设置店铺的默认货币编码。更改后若开启了多货币插件，需同步更新多货币汇率。
接口信息
- 接口地址：
{your-site-url}/api/skill/system-setting/basic-set-currency-code - 基础 URL：
{your-site-url}需替换为你自己的独立站 URL 地址，如https://your-domain.com/apimanager666 - 请求方式：
POST - 配对接口：系统-基本设置-获取
- 使用流程：通过 Get 接口获取当前配置 → 修改
currency值 → 调用本接口保存 → 同步多货币汇率
认证
请求头需携带 skill-access-token：
| 请求头 | 必填 | 说明 |
|---|---|---|
skill-access-token |
是 | {your-skill-access-token}（请替换为你自己的 token） |
Content-Type |
是 | 固定为 application/json |
请求参数
以 JSON Body 形式传递。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
currency |
string | 是 | 货币编码，如 USD、EUR、CNY |
请求示例
cURL
curl --location --request POST '{your-site-url}/api/skill/system-setting/basic-set-currency-code' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"currency": "USD"
}'
返回结果
{
"code": 200,
"data": [],
"message": "success"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
code |
int | 状态码，200 表示成功 |
message |
string | 提示信息 |
data |
array | 成功时为空数组 [] |
注意事项
currency必须为有效的货币编码（如USD、EUR、CNY），可从 店铺支持的多货币信息 获取。- 更改默认货币后，如果店铺开启了多货币插件，必须前往插件执行多货币汇率更新，参看：插件：多货币。
- api：多货币-获取配置 ， 多货币-获取实时货币汇率， 多货币-保存配置
- 与 系统-基本设置-获取 配对，先用 Get 获取当前
currency值，修改后调用本接口。