ดึงบล็อกและผสานสคริปต์ CEL ระดับฟิลด์ที่ประเมินแล้วเข้ากับเนื้อหาที่เผยแพร่.
เหมือนกับ GET /blocks แต่มีการประเมินสคริปต์ CEL ระดับฟิลด์ที่ลงทะเบียนไว้สำหรับแต่ละบล็อกเพิ่มเติม และผสานผลลัพธ์เข้ากับ published_content ของแต่ละบล็อก ใช้เมื่อบล็อกมีฟิลด์ที่คำนวณค่า
การยืนยันตัวตน: คีย์ API (x-api-key header หรือ api_key query param).
| พารามิเตอร์ | ประเภท | จำเป็น | หมายเหตุ |
|---|---|---|---|
websiteId | uuid | ไม่ | เว็บไซต์เป้าหมาย หากไม่ระบุจะใช้ค่าจากส่วนหัว Host หรือการกำหนดค่า. |
blockIds | string | ไม่ | UUID ของบล็อกที่คั่นด้วยจุลภาค หมายเหตุ: ใช้ blockIds ไม่ใช่ ids. |
routePath | string | ไม่ | เส้นทางของรูทสำหรับบริบท meta ของ CEL. |
params | string | ไม่ | อ็อบเจ็กต์ JSON ของพารามิเตอร์รูทที่เข้ารหัสเป็น URL เช่น {"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 จะถูกละไว้เมื่อไม่มีการคำนวณ และ CEL จะถูกรวมเข้ามาเฉพาะเมื่อบล็อกมี published_content ที่ไม่เป็น null
curl '{CMS_API_URL}/blocks/with-cel-cache?websiteId=<uuid>&blockIds=<id1>,<id2>&locale=en' \
-H 'x-api-key: <key>'
400 — UUID ไม่ถูกต้องใน blockIds หรือไม่สามารถระบุเว็บไซต์ได้401 — คีย์ API ไม่ถูกต้อง500 — เอนจิน CEL ขัดข้อง