Umetnite ili ažurirajte varijantu dokumenta prilagođene komponente, ključenu prema id-u dokumenta.
Umetnite ili ažurirajte varijantu (redak tablice documents) prilagođene komponente, ključenu prema id dokumenta. Navedite id kako biste ažurirali postojeću varijantu; izostavite ga za umetanje nove. Dostupno i na /schemas/{schema_name}. Sadržaj se validira prema shemi komponente.
Autentikacija: API ključ — uvijek obavezan, a ključ mora imati dozvolu content_write.
| Parametar | Vrsta | Obavezno | Napomene |
|---|---|---|---|
schema_name | znakovni niz | da | Naziv prilagođene komponente. |
| Parametar | Vrsta | Obavezno | Napomene |
|---|---|---|---|
websiteId | uuid | ne | Ciljana web-stranica; u nedostatku vrijednosti koristi zaglavlje Host / konfiguraciju. |
api_key | znakovni niz | ne | Alternativa zaglavlju x-api-key. |
{
"id": "<uuid>",
"title": "Moja varijanta",
"content": { "title": "Pozdrav", "body": "..." }
}
| Polje | Vrsta | Obavezno | Napomene |
|---|---|---|---|
id | uuid | ne | Ažurira odgovarajuću varijantu ako postoji; umeće novu kada nedostaje ili nije pronađena. |
title | znakovni niz | ne | Prikazni naslov. Zadana vrijednost pri umetanju je "Bez naslova"; pri ažuriranju ostaje nepromijenjen ako je izostavljen. |
content | objekt | da | Vrijednosti polja, validirane prema shemi komponente. Mora biti JSON objekt. |
{
"id": "...",
"schema_name": "objava",
"title": "Moja varijanta",
"status": "nacrt",
"version": 2,
"created": true
}
created je true pri umetanju (HTTP 201), a false pri ažuriranju (HTTP 200).
curl -X PATCH '{CMS_API_URL}/dataset/objava?websiteId=<uuid>' \
-H 'x-api-key: <ključ>' \
-H 'Content-Type: application/json' \
-d '{"content":{"title":"Pozdrav"}}'
400 — nevažeći websiteId, content koji nije objekt, nepoznata ili arhivirana komponenta ili neuspjela validacija401 — nedostaje API ključ ili je nevažeći403 — ključ nema dozvolu content_write404 — naveden je id, ali nema odgovarajuće varijante