系统模版-列表
概念说明
模板体系分为三层关系：
- 系统模板（本接口）——平台提供的原始模板资源，每个模板有唯一的
identity - 添加到店铺 —— 通过 系统模版-添加到店铺 将系统模板添加到当前店铺
- 店铺模板 —— 添加后，创建店铺模版，通过 店铺模版-列表 查看
一个系统模板可以被添加多次，每次添加生成一个独立的店铺模板，互不影响。
接口信息
- 接口地址:
{your-site-url}/api/skill/theme/get-addons-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-addons-theme-list' \
--header 'skill-access-token: {your-skill-access-token}'
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": [
{
"identity": "default_theme",
"name": "默认模板",
"description": "默认模板",
"img": "system/theme/fecify_default.png"
},
{
"id": 205,
"addons_id": 28,
"identity": "platform_theme",
"name": {
"name": "综合站模板-默认",
"lang_params": {
"en": "综合站模板-en",
"tw": "综合站模板-tw"
}
},
"img": "/system/addons/platform_theme.png",
"description": {
"name": "综合站模板",
"lang_params": {
"en": "",
"tw": ""
}
}
}
],
"message": "success"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
code |
Number | 状态码，200 表示成功 |
message |
String | 执行结果的文字描述 |
data |
Array[Object] | 主题列表 |
data 子项字段
| 字段 | 类型 | 说明 |
|---|---|---|
id |
int | 主题记录 ID（系统默认模板无此字段） |
addons_id |
int | 插件 ID（系统默认模板无此字段） |
identity |
string | 模板唯一标识 key。 |
name |
string / Object | 模板名称。可能为纯字符串，也可能为多语言对象 {name, lang_params} |
img |
string | 模板缩略图路径。完整 URL = public_url + img，其中 public_url 从 得到网站基础URL 获取 |
description |
string / Object | 模板描述。可能为纯字符串，也可能为多语言对象 {name, lang_params} |
name / description 多语言对象结构
当 name 或 description 为 JSON 对象时，结构如下：
| 字段 | 类型 | 说明 |
|---|---|---|
name |
string | 默认语言的名称/描述 |
lang_params |
Object | 各语言的翻译，key 为语言代码（如 en、tw），value 为对应翻译文本 |
注意事项
- 系统默认模板（
default_theme）无id和addons_id字段 img完整 URL 通过public_url+img拼接，public_url从 得到网站基础URL 获取identity字段是模板的唯一标识name和description可能为纯字符串或包含多语言的对象，需做类型判断