Insérez ou mettez à jour une variante de document d’un composant personnalisé, indexée sur l’identifiant du document.
Insérez ou mettez à jour une variante (une ligne documents) d’un composant personnalisé, indexée sur l’id du document. Fournissez l’id pour mettre à jour une variante existante ; omettez-le pour en insérer une nouvelle. Également disponible à /schemas/{schema_name}. Le contenu est validé par rapport au schéma du composant.
Auth : clé API — toujours requise, et la clé doit disposer de l’autorisation content_write.
| Paramètre | Type | Obligatoire | Remarques |
|---|---|---|---|
schema_name | string | oui | Le nom du composant personnalisé. |
| Paramètre | Type | Obligatoire | Remarques |
|---|---|---|---|
websiteId | uuid | non | Site web cible ; se replie sur l’en-tête/configuration Host. |
api_key | string | non | Alternative à l’en-tête x-api-key. |
{
"id": "<uuid>",
"title": "Ma variante",
"content": { "title": "Bonjour", "body": "..." }
}
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
id | uuid | non | Met à jour la variante correspondante lorsqu’elle est présente ; l’insère lorsqu’elle est absente ou introuvable. |
title | string | non | Titre affiché. Défaut à "Sans titre" lors de l’insertion ; reste inchangé lors de la mise à jour si omis. |
content | object | oui | Valeurs des champs, validées par rapport au schéma du composant. Doit être un objet JSON. |
{
"id": "...",
"schema_name": "post",
"title": "Ma variante",
"status": "brouillon",
"version": 2,
"created": true
}
created vaut true lors de l’insertion (HTTP 201) et false lors de la mise à jour (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":"Bonjour"}}'
400 — websiteId invalide, content non objet, composant inconnu ou archivé, ou échec de validation401 — clé API manquante ou invalide403 — clé dépourvue de l’autorisation content_write404 — id fourni mais aucune variante correspondante