Truy xuất các khối và hợp nhất các script CEL ở cấp trường đã được đánh giá vào nội dung đã xuất bản.
Giống như GET /blocks, nhưng còn đánh giá các script CEL ở cấp trường đã được đăng ký cho từng khối và hợp nhất kết quả vào published_content của mỗi khối. Sử dụng phần này khi các khối chứa những trường được tính toán.
Xác thực: Khóa API (header x-api-key hoặc tham số truy vấn api_key).
| Tham số | Kiểu | Bắt buộc | Ghi chú |
|---|---|---|---|
websiteId | uuid | không | Website đích; sẽ quay về header / cấu hình Host. |
blockIds | string | không | Các UUID của khối, phân tách bằng dấu phẩy. Lưu ý: blockIds, không phải ids. |
routePath | string | không | Đường dẫn route cho ngữ cảnh CEL meta. |
params | string | không | Đối tượng JSON tham số route được mã hóa URL, ví dụ {"code":"JFK"}. |
locale | string | không | Ngôn ngữ cho meta.locale và các tra cứu đã dịch. Mặc định en. |
api_key | string | không | Thay thế cho header x-api-key. |
{
"blocks": [
{
"id": "...",
"schema_name": "hero-block",
"published_content": {},
"cached_fields": ["hero.title", "hero.subtitle"]
}
]
}
Mỗi phần tử là một khối (cùng các trường như GET /blocks) cộng với một mảng cached_fields tùy chọn liệt kê các đường dẫn dạng dấu chấm được CEL điền. cached_fields bị lược bỏ khi không có gì được tính. CEL chỉ được hợp nhất khi khối có published_content khác null.
curl '{CMS_API_URL}/blocks/with-cel-cache?websiteId=<uuid>&blockIds=<id1>,<id2>&locale=en' \
-H 'x-api-key: <key>'
400 — UUID không hợp lệ trong blockIds, hoặc website không thể phân giải401 — Khóa API không hợp lệ500 — Lỗi động cơ CEL