Hozzon létre vagy frissítsen egy egyedi komponens dokumentumvariánst, a dokumentumazonosító alapján kulcsolva.
Hozzon létre vagy frissítsen egy egyedi komponens variánst (egy documents sor), a dokumentum id értéke alapján kulcsolva. Adja meg az id-t egy meglévő variáns frissítéséhez; hagyja el, ha újat szeretne beszúrni. Elérhető a /schemas/{schema_name} végponton is. A tartalmat a komponens sémája ellenőrzi.
Hitelesítés: API-kulcs — mindig kötelező, és a kulcsnak rendelkeznie kell a content_write jogosultsággal.
| Paraméter | Típus | Kötelező | Megjegyzések |
|---|---|---|---|
schema_name | string | igen | Az egyedi komponens neve. |
| Paraméter | Típus | Kötelező | Megjegyzések |
|---|---|---|---|
websiteId | uuid | nem | Célwebhely; alapértelmezésként a Host fejlécet / konfigurációt használja. |
api_key | string | nem | Alternatívája az x-api-key fejlécnek. |
{
"id": "<uuid>",
"title": "Saját variáns",
"content": { "title": "Helló", "body": "..." }
}
| Mező | Típus | Kötelező | Megjegyzések |
|---|---|---|---|
id | uuid | nem | Frissíti a megfelelő variánst, ha jelen van; beszúrja, ha hiányzik vagy nem található. |
title | string | nem | Megjelenített cím. Beszúráskor alapértelmezés szerint "Untitled"; frissítéskor változatlan marad, ha kihagyja. |
content | object | igen | Mezőértékek, amelyeket a komponens sémája ellenőriz. JSON-objektumnak kell lennie. |
{
"id": "...",
"schema_name": "post",
"title": "Saját variáns",
"status": "vázlat",
"version": 2,
"created": true
}
A created értéke beszúráskor true (HTTP 201), frissítéskor false (HTTP 200).
curl -X PATCH '{CMS_API_URL}/dataset/post?websiteId=<uuid>' \
-H 'x-api-key: <key>' \
-H 'Content-Type: application/json' \
-d '{"content":{"title":"Helló"}}'
400 — érvénytelen websiteId, nem objektum típusú content, ismeretlen vagy archivált komponens, illetve validációs hiba401 — hiányzó vagy érvénytelen API-kulcs403 — a kulcs nem rendelkezik content_write jogosultsággal404 — id megadva, de nincs egyező variáns