PATCH /dataset/{schema_name}

Lisa või uuenda kohandatud komponendi dokumendivarianti, mis on seotud dokumendi ID järgi.

Lisa või uuenda kohandatud komponendi varianti (tabeli documents rida), mis on seotud dokumendi id järgi. Sisesta id, et olemasolevat varianti uuendada; jäta see lisamata, kui soovid luua uue. Saadaval ka aadressil /schemas/{schema_name}. Sisu valideeritakse komponendi skeemi alusel.

Autentimine: API-võti — alati kohustuslik, ja võtmel peab olema content_write õigus.

Teeparameetrid

Parameeter	Tüüp	Kohustuslik	Märkused
`schema_name`	string	jah	Kohandatud komponendi nimi.

Päringuparameetrid

Parameeter	Tüüp	Kohustuslik	Märkused
`websiteId`	uuid	ei	Sihtveebisait; kui see puudub, kasutatakse `Host` päist või seadistust.
`api_key`	string	ei	Alternatiiv päisele `x-api-key`.

Päringu sisu

{
  "id": "<uuid>",
  "title": "Minu variant",
  "content": { "title": "Tere", "body": "..." }
}

Väli	Tüüp	Kohustuslik	Märkused
`id`	uuid	ei	Uuendab vastava variandi, kui see on olemas; lisab uue, kui see puudub või ei leitud.
`title`	string	ei	Kuvapealkiri. Lisamisel on vaikimisi `"Untitled"`; uuendamisel jääb muutmata, kui see on välja jäetud.
`content`	object	jah	Väljade väärtused, valideeritakse komponendi skeemi alusel. Peab olema JSON-objekt.

Vastus

{
  "id": "...",
  "schema_name": "post",
  "title": "Minu variant",
  "status": "mustand",
  "version": 2,
  "created": true
}

created on lisamisel true (HTTP 201) ja uuendamisel false (HTTP 200).

Näide

curl -X PATCH '{CMS_API_URL}/dataset/post?websiteId=<uuid>' \
  -H 'x-api-key: <key>' \
  -H 'Content-Type: application/json' \
  -d '{"content":{"title":"Tere"}}'

Veateated

400 — vigane websiteId, mitteobjektne content, tundmatu või arhiveeritud komponent või valideerimisviga
401 — puuduv või vigane API-võti
403 — võtmel puudub content_write õigus
404 — id on antud, kuid vastavat varianti ei leitud

Previous‹GET /content-changes (SSE)NextPOST /translation›