Fecify-模版装修库-列表
接口信息
- 接口地址:
{your-site-url}/api/skill/shop/get-theme-list
- 基础 URL:
{your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/admin
- 请求方式:
GET
- Content-Type:
application/json
- 说明: 获取模版装修库中的模版样式分页列表。模版装修库是预设的店铺装修样式集合,可添加到指定店铺使用。
认证
请求头中需要携带 skill-access-token:
| Header |
值 |
skill-access-token |
{your-skill-access-token} (请替换为你自己的 token) |
请求参数
| 参数 |
类型 |
必填 |
说明 |
pageNum |
Number |
否 |
页码,默认 1 |
pageSize |
Number |
否 |
每页条数,默认 10 |
请求示例
cURL
curl --location --request GET '{your-site-url}/api/skill/shop/get-theme-list?pageNum=1&pageSize=10' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'
返回结果
code 为 200 表示成功;code 不为 200 表示失败。
成功响应
{
"code": 200,
"data": {
"list": [
{
"id": 1021,
"shop_id": 0,
"identity": "new_default_theme_b2b",
"type": 20,
"name": "模板库-terrry",
"img": "/system/addons/new_default_theme_b2b.png",
"description": "{\"name\":\"B2B New Miron模板\",\"lang_params\":{\"en\":\"\",\"tw\":\"\"}}",
"is_default": 2,
"updated_at": "2026-07-11 06:24:44",
"created_at": "2026-07-11 06:24:44",
"remote_id": 0,
"shop_type": 20
}
],
"total": 51,
"pageSize": 10,
"totalPage": 6
},
"message": "success"
}
返回字段说明
| 字段 |
类型 |
说明 |
code |
Number |
状态码,200 表示成功 |
message |
String |
执行结果的文字描述 |
data |
Object |
分页数据,含 list、total、pageSize、totalPage |
list 子项
| 字段 |
类型 |
说明 |
id |
Number |
模版样式唯一 ID,用于添加到店铺或删除 |
shop_id |
Number |
来源店铺 ID,0 = 模板库原生 |
identity |
String |
模板标识符(对应模板插件 identity) |
type |
Number |
适用店铺类型:10 = B2C,20 = B2B |
name |
String |
模版样式名称 |
img |
String |
模版预览图路径 |
description |
String |
模版描述,可能为多语言 JSON 字符串 |
is_default |
Number |
是否默认:2 = 非默认 |
shop_type |
Number |
适用店铺类型编码 |
remote_id |
Number |
远程 ID,0 = 无远程关联 |
created_at |
String |
创建时间 |
updated_at |
String |
最后更新时间 |
注意事项
id 用于 模版装修库-添加到店铺 和 模版装修库-删除。
description 可能为 JSON 格式的多语言字符串,解析时需注意。