**版本：202601**

# 预览画布编辑

**POST** `/openapi/2026-01/themes/page-builder/update`

把一组编辑操作（`ops`）应用到传入的画布数据，返回编辑后的画布数据、渲染出的 HTML、画布文本快照与多语言词条；不保存任何数据。

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `schema` object (required)

  完整的画布数据（Page Builder 的 ProjectData）
- `ops` object[]

  要应用的 ops；默认重新导出

```json
{
  "schema": {},
  "ops": [
    {}
  ]
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `schema` object

    编辑后的完整画布数据
  - `text` string

    应用 ops 后的新画布文本快照
  - `html` string

    渲染出的 liquid/html
  - `translation` object[]

    i18n 词条，每项 `{key,label,type,value}`
  - `failures` object[]

    执行失败的 op 列表
  - `timings` object

    耗时统计

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "schema": {},
    "text": "string",
    "html": "string",
    "translation": [
      {}
    ],
    "failures": [
      {}
    ],
    "timings": {}
  }
}
```