**版本：202607**

# 主题卡片

查询可添加卡片与管理自定义卡片模板

卡片是页面的组成单元：section 卡片直接摆放在页面上，block 卡片放在 section 内。AI 卡片是用 liquid 代码新建的 block 卡片，通常由 AI 生成；高级卡片是在 Page Builder 里搭出的可视化卡片，来自平台的公共模板或商家的自定义卡片模板。

提供查询可添加卡片（聚合 theme、pb、custom、extension、public、gen 各来源）、公共卡片与应用扩展卡片，以及保存与删除自定义卡片模板、渲染模板画布快照、预览画布编辑等接口。 这组接口不需要编辑会话；在会话中摆放、编排或新建卡片，见「主题会话」。

- [查询可添加卡片列表](/zh-CN/api/theme-cards-list) `GET /openapi/2026-07/themes/cards`: 聚合当前主题下 `theme`、`pb`、`custom`、`extension`、`public`、`gen` 各来源的可添加卡片，已去重、按来源排序，支持分页。

- [查询公共卡片列表](/zh-CN/api/theme-public-blocks-list) `GET /openapi/2026-07/themes/public-blocks`: 返回某模板、主题下可用的公共卡片列表。

- [查询应用扩展卡片列表](/zh-CN/api/theme-extensions-list) `GET /openapi/2026-07/themes/extensions`: 返回某模板下可添加的应用扩展卡片，按应用分组。

- [保存自定义卡片模板](/zh-CN/api/theme-pb-template-save) `POST /openapi/2026-07/themes/page-builder/custom-templates`: 基于已有模板保存一个自定义卡片模板，由 `action` 决定保存方式。三种方式都会生成新的模板 id，`update` 会让原模板下线。

- [删除自定义卡片模板](/zh-CN/api/theme-pb-template-delete) `DELETE /openapi/2026-07/themes/page-builder/custom-templates/:template_id`: 按 id 删除自定义卡片模板。

- [渲染模板画布快照](/zh-CN/api/theme-pb-summary) `POST /openapi/2026-07/themes/page-builder/summary`: 传入模板 id 或完整的画布数据，返回画布的文本快照；每个节点带 `#path` 编号，可用于在编辑操作里定位节点。

- [预览画布编辑](/zh-CN/api/theme-pb-update) `POST /openapi/2026-07/themes/page-builder/update`: 把一组编辑操作（`ops`）应用到传入的画布数据，返回编辑后的画布数据、渲染出的 HTML、画布文本快照与多语言词条；不保存任何数据。