开放Api-得到模版列表
接口信息
- 接口地址:
{your-site-url}/manager/api/apps/openapi/base/get-shop-theme-list - 基础 URL:
{your-site-url}需替换为你自己的独立站 URL 地址，如https://your-domain.com - 请求方式:
GET - 说明: 此接口通过 OpenAPI 通道获取店铺已安装的主题（模板）列表
认证
此接口使用 OpenAPI 通道认证，需要同时携带以下请求头：
| Header | 值 | 说明 |
|---|---|---|
open-access-token |
{your-open-access-token} |
OpenAPI 访问令牌 |
请求参数
无需传递请求参数。
请求示例
cURL
curl --location --request GET '{your-site-url}/manager/api/apps/openapi/base/get-shop-theme-list' \
--header 'open-access-token: {your-open-access-token}' \
--data-raw ''
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": [
{
"id": 816,
"shop_id": 15,
"identity": "new_default_theme",
"type": 0,
"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 | 主题底层标识符。 |
type |
int | 主题类型，固定为 0 |
name |
string/Object | 主题名称。新架构主题为字符串，旧架构主题为多语言对象 |
img |
string | 主题缩略图路径 |
description |
string/Object | 主题描述。新架构主题为字符串，旧架构主题为多语言对象 |
is_default |
int | 是否为当前启用的主题。1 = 当前使用中，2 = 非当前主题 |
updated_at |
string | 最后更新时间 |
created_at |
string | 创建时间 |
remote_id |
int | 远程 ID，固定为 0 |
preview_url |
string | 主题预览链接 |
name / description 多语言格式（旧架构主题）
当主题为旧架构时，name 和 description 为对象格式：
{
"name": "B2C 大类模板 - 正式",
"lang_params": {
"en": "B2C大类-en",
"tw": "B2C大类-tw"
}
}
| 嵌套字段 | 类型 | 说明 |
|---|---|---|
name |
string | 默认语言的名称/描述 |
lang_params |
Object | 各语言版本，key 为语言简码，value 为对应翻译 |
注意事项
- 此接口为 GET 请求，无需传参
is_default为1的即为当前店铺正在使用的主题- 通过
preview_url可直接预览该主题效果