**版本：202607**

# 主题文件

读写主题文件、文件版本历史与自定义模板

主题文件即组成主题的布局、模板、区块、片段、资产、配置和语言环境文件。文件读写对应后台的代码编辑器；这组接口直接作用于主题，不需要编辑会话。

提供查询文件树，新建、查询、更新、重命名、删除文件，查询文件版本历史，以及管理绑定到商品、专辑、自定义页的自定义模板等接口。

- [查询主题文件树](/zh-CN/api/theme-doc-tree) `GET /openapi/2026-07/themes/:theme_id/doctree`: 获取指定主题的文件树结构。

- [查询主题文件](/zh-CN/api/theme-doc-file) `GET /openapi/2026-07/themes/:theme_id/doc`: 获取指定主题中特定文件的详情。

- [创建主题文件](/zh-CN/api/theme-doc-create) `POST /openapi/2026-07/themes/:theme_id/doc`: 在指定主题中创建新文件。

- [删除主题文件](/zh-CN/api/theme-doc-delete) `DELETE /openapi/2026-07/themes/:theme_id/doc`: 根据主题 ID、文件类型和文件路径删除指定主题文件。`assets/theme.css` 和 `layout/theme.layout` 不能删除；删除仍在页面上使用的卡片文件不会报错，页面上的对应卡片将不再显示。

- [更新主题文件](/zh-CN/api/theme-doc-patch) `PATCH /openapi/2026-07/themes/:theme_id/doc`: 用新内容整体替换指定文件；修改默认主题的文件会直接在店铺前台生效，每次修改都会记入文件版本历史。

- [重命名主题文件](/zh-CN/api/theme-doc-rename) `PUT /openapi/2026-07/themes/:theme_id/doc-rename`: 重命名指定主题中的现有文件。

- [查询全部主题文件的版本列表](/zh-CN/api/theme-doc-version) `GET /openapi/2026-07/themes/:theme_id/doc/version-records`: 返回指定主题中所有文件的版本历史。

- [查询单个主题文件的版本列表](/zh-CN/api/theme-doc-versions) `GET /openapi/2026-07/themes/:theme_id/doc/versions`: 返回单个主题文件的版本历史列表。

- [查询主题文件版本详情](/zh-CN/api/theme-doc-version-detail) `GET /openapi/2026-07/themes/:theme_id/doc/versions/:version_id`: 通过版本 ID 获取主题文件的指定历史版本。

- [查询主题自定义模板列表](/zh-CN/api/theme-templates-list) `GET /openapi/2026-07/themes/:theme_id/theme-templates`: 返回绑定到商品、专辑、自定义页的自定义模板列表。

- [创建主题自定义模板](/zh-CN/api/theme-templates-create) `POST /openapi/2026-07/themes/:theme_id/theme-templates`: 一次调用即创建自定义模板并绑定到对象（商品、专辑）；`relations` 为空则只建不绑。

- [删除主题自定义模板](/zh-CN/api/theme-templates-delete) `DELETE /openapi/2026-07/themes/:theme_id/theme-templates/:template_id`: 删除指定主题下的一个自定义模板。

- [更新主题自定义模板](/zh-CN/api/theme-templates-update) `PATCH /openapi/2026-07/themes/:theme_id/theme-templates/:template_id`: 更新已有模板的绑定关系（商品、专辑）。`relations` 会整体覆盖现有绑定，传空数组或不传都会解除全部绑定。