获取区块,并将评估后的字段级 CEL 脚本合并到发布内容中。
类似于 GET /blocks,但还会评估为每个区块注册的字段级 CEL 脚本,并将结果合并到每个区块的 published_content 中。当区块包含计算字段时使用此端点。
认证: API 密钥(x-api-key 头或 api_key 查询参数)。
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
websiteId | uuid | 否 | 目标站点;回退到 Host 头/配置。 |
blockIds | string | 否 | 以逗号分隔的区块 UUID。注意:是 blockIds,不是 ids。 |
routePath | string | 否 | CEL meta 上下文的路由路径。 |
params | string | 否 | URL 编码的路由参数 JSON 对象,例如 {"code":"JFK"}。 |
locale | string | 否 | meta.locale 以及翻译查找所用的语言环境。默认值为 en。 |
api_key | string | 否 | x-api-key 头的替代方案。 |
{
"blocks": [
{
"id": "...",
"schema_name": "hero-block",
"published_content": {},
"cached_fields": ["hero.title", "hero.subtitle"]
}
]
}
每个元素都是一个区块(字段与 GET /blocks 相同),并带有一个可选的 cached_fields 数组,其中列出了由 CEL 填充的点路径。当未计算任何内容时,将省略 cached_fields。只有当区块的 published_content 非空时才会合并 CEL。
curl '{CMS_API_URL}/blocks/with-cel-cache?websiteId=<uuid>&blockIds=<id1>,<id2>&locale=en' \
-H 'x-api-key: <key>'
400 — blockIds 中的 UUID 无效,或无法解析的网站401 — API 密钥无效500 — CEL 引擎故障