查询主题自定义模板列表

GET 
/openapi/2026-01/themes/:theme_id/theme-templates

返回绑定到商品、专辑、自定义页的自定义模板列表。

请求

Path参数

theme_id string必填

主题 ID

Query参数

type string

可选，按模板类型过滤：product、collection、product_coll、page；为空返回全部类型

page int32

可选，分页页码（默认 1）

per_page int32

可选，每页数量（默认 100）

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object
countint32
模板总数
theme_templates object[]
主题模板列表
Array [
idstring
模板唯一 ID
theme_idstring
所属主题 ID
store_idstring
店铺 ID
doc_idstring
底层文档（模板文件）ID
typestring
模板类型：product（绑定商品的商品详情页）、collection（专辑详情页）、product_coll（绑定专辑的商品详情页）、page（自定义页，旧版兼容）
titlestring
模板显示名称
suffixstring
模板路由后缀
fromstring
模板创建来源（复制源模板的 suffix）
obj_idstring
首个绑定对象的 ID（商品 / 专辑 / 自定义页 id）；未绑定任何对象时为空。一个模板可绑定多个对象，总数见 count —— 该字段不会列出全部对象
obj_titlestring
首个绑定对象的显示标题（与 obj_id 指向同一对象）
sourcestring
数据操作来源：该记录由哪个入口写入。只读；与 from（复制自哪个模板）不是一回事
created_atstring
创建时间
updated_atstring
更新时间
iconstring
模板图标 URL
countstring
绑定到该模板的对象数量，以十进制字符串返回（如 12），不是数字类型
]

示例

json

{
  "code": "string",
  "message": "string",
  "data": {
    "count": 0,
    "theme_templates": [
      {
        "id": "string",
        "theme_id": "string",
        "store_id": "string",
        "doc_id": "string",
        "type": "string",
        "title": "string",
        "suffix": "string",
        "from": "string",
        "obj_id": "string",
        "obj_title": "string",
        "source": "string",
        "created_at": "string",
        "updated_at": "string",
        "icon": "string",
        "count": "string"
      }
    ]
  }
}