جلب الكتل مع ذاكرة CEL المؤقتة

جلب الكتل ودمج سكربتات CEL المُقيَّمة على مستوى الحقول في المحتوى المنشور.

مثل GET /blocks، لكنه يقيّم أيضًا سكربتات CEL على مستوى الحقول المسجَّلة لكل كتلة ويُدمج النتائج في published_content الخاصة بكل كتلة. استخدم هذا عندما تحتوي الكتل على حقول محسوبة.

المصادقة: مفتاح واجهة برمجة التطبيقات (x-api-key في الترويسة أو معامل الاستعلام api_key).

معاملات الاستعلام

المعامل	النوع	مطلوب	ملاحظات
`websiteId`	uuid	no	الموقع الهدف؛ يُرجع إلى ترويسة `Host` / الإعداد الافتراضي.
`blockIds`	string	no	معرّفات UUID للكتل مفصولة بفواصل. ملاحظة: `blockIds`، وليس `ids`.
`routePath`	string	no	مسار التوجيه لسياق `meta` الخاص بـCEL.
`params`	string	no	كائن JSON مشفَّر بصيغة URL لمعلمات المسار، مثل `{"code":"JFK"}`.
`locale`	string	no	اللغة الخاصة بـ`meta.locale` وعمليات البحث المترجمة. القيمة الافتراضية `en`.
`api_key`	string	no	بديل عن ترويسة `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 — مفتاح واجهة برمجة تطبيقات غير صالح
500 — فشل محرك CEL

Previous‹الحصول على الكتل NextGET /blocks/generated›

معاملات الاستعلام

المعامل

النوع

مطلوب

ملاحظات

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"]
    }
  ]
}