Отримайте блоки та об’єднайте виконані сценарії CEL на рівні полів із опублікованим вмістом.
Подібно до GET /blocks, але додатково виконує сценарії CEL на рівні полів, зареєстровані для кожного блоку, і об’єднує результати з published_content кожного блоку. Використовуйте це, коли блоки містять обчислювані поля.
Автентифікація: ключ API (заголовок x-api-key або параметр запиту api_key).
| Параметр | Тип | Обов’язковий | Примітки |
|---|---|---|---|
websiteId | uuid | ні | Цільовий вебсайт; за відсутності використовує заголовок Host або конфігурацію. |
blockIds | рядок | ні | UUID блоків, розділені комами. Примітка: blockIds, а не ids. |
routePath | рядок | ні | Шлях маршруту для контексту CEL meta. |
params | рядок | ні | JSON-об’єкт параметрів маршруту, закодований у форматі URL, напр., {"code":"JFK"}. |
locale | рядок | ні | Локаль для meta.locale та перекладених пошуків. Типове значення en. |
api_key | рядок | ні | Альтернатива заголовку x-api-key. |
{
"blocks": [
{
"id": "...",
"schema_name": "hero-block",
"published_content": {},
"cached_fields": ["hero.title", "hero.subtitle"]
}
]
}
Кожен елемент — це блок (ті самі поля, що й у GET /blocks) плюс необов’язковий масив cached_fields, який перелічує крапкові шляхи, заповнені CEL. cached_fields опускається, якщо нічого не було обчислено. CEL об’єднується лише тоді, коли блок має ненульовий published_content.
curl '{CMS_API_URL}/blocks/with-cel-cache?websiteId=<uuid>&blockIds=<id1>,<id2>&locale=en' \
-H 'x-api-key: <key>'
400 — некоректний UUID у blockIds або неможливо визначити вебсайт401 — недійсний ключ API500 — збій рушія CEL