店铺模版-列表
店铺模板 - 列表
店铺模板由系统模板添加而来。完整链路：系统模板列表 → 系统模版-添加到店铺 → 本接口查看结果。
接口信息
- 接口地址:
{your-site-url}/api/skill/theme/get-shop-theme-list - 基础 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/theme/get-shop-theme-list' \
--header 'skill-access-token: {your-skill-access-token}'
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": [
{
"id": 829,
"shop_id": 15,
"identity": "default_theme",
"name": "默认模板",
"img": "system/theme/fecify_default.png",
"description": "默认模板",
"is_default": 2,
"updated_at": "2026-06-05 14:57:55",
"created_at": "2026-06-05 14:57:55",
"remote_id": 0,
"preview_url": "https://diydomain.fecmall.cn?preview_theme_id=829"
},
{
"id": 828,
"shop_id": 15,
"identity": "platform_theme",
"name": {
"name": "综合站模板-默认",
"lang_params": {
"en": "综合站模板-en",
"tw": "综合站模板-tw"
}
},
"img": "/system/addons/platform_theme.png",
"description": {
"name": "综合站模板",
"lang_params": {
"en": "",
"tw": ""
}
},
"is_default": 2,
"updated_at": "2026-06-05 14:18:34",
"created_at": "2026-06-05 14:18:34",
"remote_id": 0,
"preview_url": "https://diydomain.fecmall.cn?preview_theme_id=828"
},
{
"id": 816,
"shop_id": 15,
"identity": "new_default_theme",
"name": "terry-26-01-13 B2C New Mirox模版",
"img": "/system/addons/new_default_theme.png",
"description": "B2C New Mirox模版，重构后支持liquid模版开发的新模版",
"is_default": 1,
"updated_at": "2026-01-13 19:28:19",
"created_at": "2026-01-08 12:51:06",
"remote_id": 0,
"preview_url": "https://diydomain.fecmall.cn?preview_theme_id=816"
}
],
"message": "success"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
code |
Number | 状态码，200 表示成功 |
message |
String | 执行结果的文字描述 |
data |
Array[Object] | 店铺模板列表 |
data 子项字段
| 字段 | 类型 | 说明 |
|---|---|---|
id |
int | 店铺模板 ID |
shop_id |
int | 店铺 ID |
identity |
string | 对应的系统模板唯一标识。同一个 identity 可能在列表中出现多次（同一系统模板添加了多个店铺模板） |
name |
string / Object | 店铺模板名称。可能为纯字符串，也可能为多语言对象 {name, lang_params} |
img |
string | 模板缩略图路径。完整 URL = public_url + img，其中 public_url 从 得到网站基础URL获取 |
description |
string / Object | 模板描述。可能为纯字符串，也可能为多语言对象 {name, lang_params} |
is_default |
int | 是否为当前启用的默认模板。1 = 是（一个店铺只能有一个默认模板），2 = 否 |
preview_url |
string | 模板预览 URL，可直接在浏览器中打开预览 |
created_at |
string | 创建时间 |
updated_at |
string | 最后更新时间 |
remote_id |
int | 远程 ID，用于数据同步 |
name / description 多语言对象结构
当 name 或 description 为 JSON 对象时，结构如下：
| 字段 | 类型 | 说明 |
|---|---|---|
name |
string | 默认语言的名称/描述 |
lang_params |
Object | 各语言的翻译，key 为语言代码（如 en、tw），value 为对应翻译文本 |
与系统模板列表的区别
| 接口 | 说明 |
|---|---|
| 系统模版-列表 | 返回平台支持的所有系统模板（原始资源） |
| 本接口 | 返回已添加到当前店铺的店铺模板（系统模板的实例副本） |
注意事项
- 同一个
identity可能出现多次——一个系统模板可被多次添加到店铺，生成多个店铺模板 is_default = 1表示该店铺模板为当前启用的默认模板，一个店铺只有一个默认模板- 模板
img完整 URL 通过public_url+img拼接，public_url从 得到网站基础URL 获取 name和description可能为纯字符串或包含多语言的对象，需做类型判断