Vykonajte operáciu upsert pre variant dokumentu vlastného komponentu identifikovaný podľa ID dokumentu.
Vykonajte operáciu upsert pre variant (riadok documents) vlastného komponentu, identifikovaný podľa id dokumentu. Zadajte id, ak chcete aktualizovať existujúci variant; vynechajte ho, ak chcete vložiť nový. Dostupné aj na /schemas/{schema_name}. Obsah sa validuje podľa schémy komponentu.
Autorizácia: API kľúč — vždy povinný a kľúč musí mať oprávnenie content_write.
| Parameter | Typ | Povinné | Poznámky |
|---|---|---|---|
schema_name | string | áno | Názov vlastného komponentu. |
| Parameter | Typ | Povinné | Poznámky |
|---|---|---|---|
websiteId | uuid | nie | Cieľová webová lokalita; inak sa použije hlavička / konfigurácia Host. |
api_key | string | nie | Alternatíva k hlavičke x-api-key. |
{
"id": "<uuid>",
"title": "Môj variant",
"content": { "title": "Ahoj", "body": "..." }
}
| Pole | Typ | Povinné | Poznámky |
|---|---|---|---|
id | uuid | nie | Aktualizuje zodpovedajúci variant, ak je prítomné; vloží, ak chýba alebo sa nenašlo. |
title | string | nie | Zobrazený názov. Pri vkladaní je predvolená hodnota "Untitled"; pri aktualizácii zostane nezmenený, ak je vynechaný. |
content | object | áno | Hodnoty polí, validované podľa schémy komponentu. Musí ísť o objekt JSON. |
{
"id": "...",
"schema_name": "post",
"title": "Môj variant",
"status": "koncept",
"version": 2,
"created": true
}
created je true pri vložení (HTTP 201) a false pri aktualizácii (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":"Ahoj"}}'
400 — neplatné websiteId, neobjektové content, neznámy alebo archivovaný komponent alebo zlyhanie validácie401 — chýbajúci alebo neplatný API kľúč403 — kľúč nemá oprávnenie content_write404 — id je dodané, ale chýba zodpovedajúci variant