Rufen Sie Blöcke ab und führen Sie ausgewertete CEL-Skripte auf Feldebene in veröffentlichte Inhalte zusammen.
Wie GET /blocks, wertet jedoch zusätzlich die für jeden Block registrierten CEL-Skripte auf Feldebene aus und führt die Ergebnisse in den published_content jedes Blocks zusammen. Verwenden Sie dies, wenn Blöcke berechnete Felder enthalten.
Auth: API-Schlüssel (x-api-key-Header oder api_key-Abfrageparameter).
| Parameter | Typ | Erforderlich | Hinweise |
|---|---|---|---|
websiteId | uuid | nein | Zielwebsite; fällt auf den Host-Header bzw. die Konfiguration zurück. |
blockIds | string | nein | Durch Kommas getrennte Block-UUIDs. Hinweis: blockIds, nicht ids. |
routePath | string | nein | Routenpfad für den CEL-meta-Kontext. |
params | string | nein | URL-codiertes JSON-Objekt der Routenparameter, z. B. {"code":"JFK"}. |
locale | string | nein | Gebietsschema für meta.locale und übersetzte Nachschlagevorgänge. Standardwert en. |
api_key | string | nein | Alternative zum Header x-api-key. |
{
"blocks": [
{
"id": "...",
"schema_name": "hero-block",
"published_content": {},
"cached_fields": ["hero.title", "hero.subtitle"]
}
]
}
Jedes Element ist ein Block (mit denselben Feldern wie bei GET /blocks) plus ein optionales cached_fields-Array, das die von CEL gefüllten Punkt-Pfade auflistet. cached_fields wird weggelassen, wenn nichts berechnet wurde. CEL wird nur zusammengeführt, wenn der Block einen nicht-leeren published_content besitzt.
curl '{CMS_API_URL}/blocks/with-cel-cache?websiteId=<uuid>&blockIds=<id1>,<id2>&locale=en' \
-H 'x-api-key: <key>'
400 — ungültige UUID in blockIds oder nicht auflösbare Website401 — ungültiger API-Schlüssel500 — CEL-Engine-Fehler