系统-基本设置-保存
系统设置 - 基础设置
接口信息
- 接口地址:
{your-site-url}/api/skill/system-setting/basic-set - 基础 URL:
{your-site-url}需替换为你自己的独立站 URL 地址，如https://your-domain.com/apimanager666 - 请求方式:
POST - Content-Type:
application/json - 说明: 此接口用于保存系统基础设置
认证
请求头中需要携带 skill-access-token：
| Header | 值 |
|---|---|
skill-access-token |
{your-skill-access-token} （请替换为你自己的 token） |
请求参数 (JSON Body)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
site_status |
int | ✅ 必填 | 网站状态。1 = 开启，2 = 关闭 |
site_name |
string | ✅ 必填 | 网站名称 |
site_logo |
string | ✅ 必填 | 网站 Logo 图片路径。可使用已有路径，或通过 图片-上传图片 上传后获取 data.path 作为值 |
site_ico |
string | ✅ 必填 | 网站 ICO 图标路径，可为空字符串 ""。可通过 图片-上传图片 上传后获取 data.path 作为值 |
site_email |
string | ✅ 必填 | 网站邮箱 |
language |
string | ✅ 必填 | 网站语言代码。该值必须从 店铺支持的多语言列表 返回的 data.shop_language_list 数组子项中的 code 中获取，不可随意填写 |
timezone |
string | ✅ 必填 | 时区，取值需从 得到网站时区列表 返回的 key 中获取，不可使用其他值 |
order_guest_query |
int | ✅ 必填 | 游客订单查询。1 = 开启，2 = 关闭 |
order_number_prefix |
string | ✅ 必填 | 订单编号前缀，可为空字符串 "" |
order_number_suffix |
string | ✅ 必填 | 订单编号后缀，可为空字符串 "" |
handle_type |
int | ✅ 必填 | Handle 生成模式。1 = 仅字母数字下划线连接符（类似 Shopify），2 = 更广泛匹配（支持中文、俄文等非字母字符），适合非英语网站 |
请求示例
cURL
curl --location --request POST '{your-site-url}/api/skill/system-setting/basic-set' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"site_status": 1,
"site_name": "fecify331",
"site_logo": "/common/15/image/2023/04/27/xxx.png",
"site_ico": "",
"site_email": "fecify@126.com",
"language": "en",
"timezone": "Asia/Hong_Kong",
"order_guest_query": 1,
"order_number_prefix": "",
"order_number_suffix": "",
"handle_type": 1
}'
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": [],
"message": "success"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
code |
Number | 状态码，200 表示成功 |
message |
String | 执行结果的文字描述 |
data |
Array | 返回数据，目前为空数组 |
注意事项
- 所有字段均为必填，其中
order_number_prefix、order_number_suffix、site_ico可传空字符串"" - 语言字段
language特别注意：language的值必须从 店铺支持的多语言列表 返回的data.shop_language_list数组子项的code中获取，不可随意填写，否则可能导致语言设置无效 - 时区字段
timezone特别注意：timezone的值必须从 得到网站时区列表 返回的数据中获取，返回格式为{"key": "Asia/Hong_Kong", "label": "(GMT+08:00) Shanghai"}，请使用其中的key作为timezone字段的值，不可使用自定义或其他非列表内的时区值，否则可能导致系统异常 handle_type影响创建商品、专辑、自定义页面、博客文章、博客专辑时的 URL handle 生成方式- 调用本api，需要先调用：系统-基本设置-获取 ，获取值后，再修改值，然后再保存
- 注意：api保存是全量保存，即时您只配置修改一个选项，也要进行全量保存，因此，先通过
获取api得到数据，然后进行更改数据，然后进行保存