Introduceți sau actualizați o variantă de document a unui component personalizat, indexată după id-ul documentului.
Introduceți sau actualizați o variantă (un rând din documents) a unui component personalizat, indexată după id-ul documentului. Furnizați id pentru a actualiza o variantă existentă; omiteți-l pentru a insera una nouă. Disponibil și la /schemas/{schema_name}. Conținutul este validat în raport cu schema componentului.
Autentificare: Cheie API — întotdeauna necesară, iar cheia trebuie să dețină permisiunea content_write.
| Parametru | Tip | Obligatoriu | Observații |
|---|---|---|---|
schema_name | string | da | Numele componentului personalizat. |
| Parametru | Tip | Obligatoriu | Observații |
|---|---|---|---|
websiteId | uuid | nu | Site-ul țintă; se revine la antetul Host / configurație. |
api_key | string | nu | Alternativă la antetul x-api-key. |
{
"id": "<uuid>",
"title": "Varianta mea",
"content": { "title": "Salut", "body": "..." }
}
| Câmp | Tip | Obligatoriu | Observații |
|---|---|---|---|
id | uuid | nu | Actualizați varianta corespunzătoare când este prezent; inserați când lipsește sau nu este găsită. |
title | string | nu | Titlu de afișare. Implicit "Fără titlu" la inserare; lăsat neschimbat la actualizare când este omis. |
content | object | da | Valorile câmpurilor, validate în raport cu schema componentului. Trebuie să fie un obiect JSON. |
{
"id": "...",
"schema_name": "post",
"title": "Varianta mea",
"status": "ciornă",
"version": 2,
"created": true
}
created este true la inserare (HTTP 201) și false la actualizare (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":"Salut"}}'
400 — websiteId invalid, content care nu este obiect, componentă necunoscută sau arhivată, sau eșec la validare401 — cheie API lipsă sau invalidă403 — cheia nu are permisiunea content_write404 — id furnizat, dar nu există nicio variantă potrivită