版本：202506

主题

管理店铺主题的安装、配置与资源文件编辑

主题用于控制店铺前台的视觉布局与模板，由布局、模板、区块、片段、资产、配置和语言环境文件组成。

提供查询主题列表、查询主题详情、删除主题、发布主题、升级主题、查询默认主题与后台任务、查询主题文档树、创建/查询/更新/重命名/删除主题文件，以及查询主题文件版本历史等接口。

📄️查询主题列表

返回主题列表。

通过主题 ID 获取指定主题的详情。

通过主题 ID 删除指定主题。默认主题不能删除。

获取店铺默认主题的详情。

将指定主题发布为当前使用主题。

获取主题上传、升级等后台任务的状态和详情。

基于指定主题生成一个升级到最新版本的新主题，并沿用原主题的配置，原主题保持不变；返回新主题 ID。

获取指定主题的文件树结构。

获取指定主题中特定文件的详情。

在指定主题中创建新文件。

根据主题 ID、文件类型和文件路径删除指定主题文件。`assets/theme.css` 和 `layout/theme.layout` 不能删除；删除仍在页面上使用的卡片文件不会报错，页面上的对应卡片将不再显示。

用新内容整体替换指定文件；修改默认主题的文件会直接在店铺前台生效，每次修改都会记入文件版本历史。

重命名指定主题中的现有文件。

返回单个主题文件的版本历史列表。

通过版本 ID 获取主题文件的指定历史版本。

返回指定主题中所有文件的版本历史。