版本:202601
主题卡片
查询可添加卡片与管理自定义卡片模板
卡片是页面的组成单元:section 卡片直接摆放在页面上,block 卡片放在 section 内。AI 卡片是用 liquid 代码新建的 block 卡片,通常由 AI 生成;高级卡片是在 Page Builder 里搭出的可视化卡片,来自平台的公共模板或商家的自定义卡片模板。
提供查询可添加卡片(聚合 theme、pb、custom、extension、public、gen 各来源)、公共卡片与应用扩展卡片,以及保存与删除自定义卡片模板、渲染模板画布快照、预览画布编辑等接口。 这组接口不需要编辑会话;在会话中摆放、编排或新建卡片,见「主题会话」。
查询可添加卡片列表
聚合当前主题下 `theme`、`pb`、`custom`、`extension`、`public`、`gen` 各来源的可添加卡片,已去重、按来源排序,支持分页。
查询公共卡片列表
返回某模板、主题下可用的公共卡片列表。
查询应用扩展卡片列表
返回某模板下可添加的应用扩展卡片,按应用分组。
保存自定义卡片模板
基于已有模板保存一个自定义卡片模板,由 `action` 决定保存方式。三种方式都会生成新的模板 id,`update` 会让原模板下线。
删除自定义卡片模板
按 id 删除自定义卡片模板。
渲染模板画布快照
传入模板 id 或完整的画布数据,返回画布的文本快照;每个节点带 `#path` 编号,可用于在编辑操作里定位节点。
预览画布编辑
把一组编辑操作(`ops`)应用到传入的画布数据,返回编辑后的画布数据、渲染出的 HTML、画布文本快照与多语言词条;不保存任何数据。