系统-国家设置-获取
系统设置 - 国家设置获取
接口信息
- 接口地址:
{your-site-url}/api/skill/system-setting/country-get - 基础 URL:
{your-site-url}需替换为你自己的独立站 URL 地址，如https://your-domain.com/apimanager666 - 请求方式:
GET - 说明: 此接口用于获取当前国家相关配置。该配置用于订单结账页面收货地址部分，控制国家下拉列表的内容
认证
请求头中需要携带 skill-access-token：
| Header | 值 |
|---|---|
skill-access-token |
{your-skill-access-token} （请替换为你自己的 token） |
请求参数
无需传参。
请求示例
cURL
curl --location --request GET '{your-site-url}/api/skill/system-setting/country-get' \
--header 'skill-access-token: {your-skill-access-token}' \
--data-raw ''
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": {
"status": 2,
"countrys": ["AL", "DZ", "CX", "CC"],
"sorts": ["AX", "AL"]
},
"message": "success"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
code |
Number | 状态码，200 表示成功 |
message |
String | 执行结果的文字描述 |
data |
Object | 当前国家配置数据 |
data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
status |
int | 展示国家类型。1 = 所有国家/地区，2 = 选中的国家/地区 |
countrys |
Array[string] | 选中的国家简码数组。当 status 为 2 时有效，status 为 1 时无效 |
sorts |
Array[string] | 国家优先级排序数组。排序中的国家简码优先显示在下拉列表顶部 |
注意事项
- GET 请求，无需传参
- 此接口通常用于配合 系统-国家设置-保存 使用：先通过本接口获取当前配置，修改后再调用保存接口全量提交