查询主题列表

GET 
/openapi/2025-06/themes

返回主题列表。

请求

Query参数

published string

按发布状态过滤主题。"0" 表示未发布，"1" 表示已发布

cursor string

分页游标，使用上次响应中返回的游标获取下一页

page_size int32

每页返回的主题数量，范围 1-250，默认 10

ids string[]

用于筛选的主题 ID 列表，仅返回匹配指定 ID 的主题。 示例：?ids=1001&ids=1002

contain_ext_theme boolean

返回结果中是否包含扩展主题

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

countint32

数量

themes object[]

主题列表

Array [

idstring

主题的唯一标识

namestring

主题名称

merchant_theme_idstring

商家主题 ID

merchant_theme_namestring

商家主题名称

merchant_theme_infostring

主题版本标识

localestring

主题语言环境（如 en-US、zh-CN）

presetstring

主题风格

typestring

主题类型：

• shoplazza：shoplazza内部主题
• developer：第三方开发者主题

descstring

主题的多语言描述

defaultstring

是否为默认主题（0 或 1）

pc_cover_urlstring

PC 端封面图片 URL

mobile_cover_urlstring

移动端封面图片 URL

publishedstring

主题是否已发布（0 或 1）

is_auto_upgradestring

主题是否自动升级

statusstring

主题的状态

updated_atstring

主题最后更新时间

publish_timestring

发布时间

auto_save_timestring

自动保存时间

theme_save_timestring

主题最后保存时间

versionstring

当前主题版本

c_versionstring

当前客户端版本

change_logstring

主题的更新日志信息

version_publish_timestring

版本发布时间

newest_c_versionstring

最新可用客户端版本

has_newest_versionboolean

主题是否为最新版本

has_draftboolean

是否有草稿

theme_version_idstring

主题的版本 ID

]

cursorstring

下一页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "count": 0,
    "themes": [
      {
        "id": "string",
        "name": "string",
        "merchant_theme_id": "string",
        "merchant_theme_name": "string",
        "merchant_theme_info": "string",
        "locale": "string",
        "preset": "string",
        "type": "string",
        "desc": "string",
        "default": "string",
        "pc_cover_url": "string",
        "mobile_cover_url": "string",
        "published": "string",
        "is_auto_upgrade": "string",
        "status": "string",
        "updated_at": "string",
        "publish_time": "string",
        "auto_save_time": "string",
        "theme_save_time": "string",
        "version": "string",
        "c_version": "string",
        "change_log": "string",
        "version_publish_time": "string",
        "newest_c_version": "string",
        "has_newest_version": true,
        "has_draft": true,
        "theme_version_id": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}