השגת-בלוקים-עם-מטמון-CEL

שלפו בלוקים ומזגו את סקריפטי CEL שהוערכו ברמת השדה אל התוכן שפורסם.

בדומה ל-GET /blocks, אך בנוסף מפעיל את סקריפטי CEL ברמת השדה הרשומים לכל בלוק וממזג את התוצאות אל published_content של כל בלוק. השתמשו בכך כאשר הבלוקים מכילים שדות מחושבים.

אימות: מפתח API (כותרת x-api-key או פרמטר השאילתה api_key).

פרמטרי שאילתה

פרמטר	סוג	נדרש	הערות
`websiteId`	uuid	לא	אתר היעד; מתבסס על כותרת `Host` או על התצורה.
`blockIds`	string	לא	UUID של בלוקים מופרדים בפסיק. שימו לב: `blockIds`, לא `ids`.
`routePath`	string	לא	נתיב המסלול עבור ההקשר `meta` של CEL.
`params`	string	לא	אובייקט JSON המקודד ל-URL של פרמטרי המסלול, למשל `{"code":"JFK"}`.
`locale`	string	לא	ערך locale עבור `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

Previous‹קבלת בלוקים NextGET /blocks/generated›

פרמטרי שאילתה

פרמטר

סוג

נדרש

הערות

websiteId

uuid

לא

אתר היעד; מתבסס על כותרת Host או על התצורה.

blockIds

string

לא

UUID של בלוקים מופרדים בפסיק. שימו לב: blockIds, לא ids.

routePath

string

לא

נתיב המסלול עבור ההקשר meta של CEL.

params

string

לא

אובייקט JSON המקודד ל-URL של פרמטרי המסלול, למשל {"code":"JFK"}.

locale

string

לא

ערך locale עבור meta.locale ולחיפושים מתורגמים. ברירת המחדל en.

api_key

string

לא

חלופה לכותרת x-api-key.

תגובה

{
  "blocks": [
    {
      "id": "...",
      "schema_name": "hero-block",
      "published_content": {},
      "cached_fields": ["hero.title", "hero.subtitle"]
    }
  ]
}