profound-logoProfound CMS
⌘K
Admin
Theme
DocsTutorialBlogPhilosophy
DocsTutorialBlogPhilosophy

Hybrid

Collection of Pages with ComponentsTypes of ComponentsSetup server sent events (SSE) content refetchInstall Profound CMS as a proxyCEL Scripting in Template BuilderProject ScaffoldingMedia Library

Headless

Quick startJSON 与 Claude 代码组件 Zod 拉取

REST API

REST API 概览get连接网站 APIgetGET /routesgetGET /routegetGET /blocksget获取带有 CEL 缓存的区块getGET /blocks/generatedgetGET /componentsgetGET /components/{name}getGET /dataset/{schema_name}get获取内容变更 SSEpatchPATCH /dataset/{schema_name}postPOST /translationpatchPATCH /translationsgetGET /usagepostPOST /csvpatch修补 CSV
All Systems Operational
Powered Byprofound-logo
Theme

获取带有 CEL 缓存的区块

获取区块,并将评估后的字段级 CEL 脚本合并到发布内容中。

类似于 GET /blocks,但还会评估为每个区块注册的字段级 CEL 脚本,并将结果合并到每个区块的 published_content 中。当区块包含计算字段时使用此端点。

认证: API 密钥(x-api-key 头或 api_key 查询参数)。

查询参数

参数类型是否必填说明
websiteIduuid否目标站点;回退到 Host 头/配置。
blockIdsstring否以逗号分隔的区块 UUID。注意:是 blockIds,不是 ids。
routePathstring否CEL meta 上下文的路由路径。
paramsstring否URL 编码的路由参数 JSON 对象,例如 {"code":"JFK"}。
localestring否meta.locale 以及翻译查找所用的语言环境。默认值为 en。
api_keystring否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 引擎故障
Continue Reading
Previous‹GET /blocksNextGET /blocks/generated›