Oppdater eller sett inn en dokumentvariant av en egendefinert komponent, nĂžkkelsatt etter dokumentets id.
Oppdater eller sett inn en variant (en documents-rad) av en egendefinert komponent, nÞkkelsatt etter dokumentets id. Oppgi id for Ä oppdatere en eksisterende variant; utelat den for Ä sette inn en ny. OgsÄ tilgjengelig pÄ /schemas/{schema_name}. Innholdet blir validert mot komponentens skjema.
Autentisering: API-nĂžkkel â alltid pĂ„krevd, og nĂžkkelen mĂ„ ha tillatelsen content_write.
| Parameter | Type | PĂ„krevd | Merknader |
|---|---|---|---|
schema_name | string | ja | Navnet pÄ den egendefinerte komponenten. |
| Parameter | Type | PĂ„krevd | Merknader |
|---|---|---|---|
websiteId | uuid | nei | MĂ„lnettsted; faller tilbake til Host-header / konfigurasjon. |
api_key | string | nei | Alternativ til x-api-key-headeren. |
{
"id": "<uuid>",
"title": "Varianten min",
"content": { "title": "Hei", "body": "..." }
}
| Felt | Type | PĂ„krevd | Merknader |
|---|---|---|---|
id | uuid | nei | Oppdater den tilsvarende varianten nÄr den finnes; sett inn nÄr den mangler eller ikke blir funnet. |
title | string | nei | Visningstittel. Standardverdi er \"Uten tittel\" ved innsetting; forblir uendret ved oppdatering nÄr den utelates. |
content | object | ja | Feltverdier, validert mot komponentens skjema. MĂ„ vĂŠre et JSON-objekt. |
{
"id": "...",
"schema_name": "post",
"title": "Varianten min",
"status": "utkast",
"version": 2,
"created": true
}
created er true ved innsetting (HTTP 201) og false ved oppdatering (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\":\"Hei\"}}'
400 â ugyldig websiteId, content som ikke er et objekt, ukjent eller arkivert komponent, eller valideringsfeil401 â manglende eller ugyldig API-nĂžkkel403 â nĂžkkelen mangler tillatelsen content_write404 â id oppgitt, men ingen samsvarende variant