Content Type

Un Content Type est le modèle (schéma) que suit un contenu. Il définit quels champs il possède et, pour chaque champ, son type, s'il est multilingue, s'il est obligatoire et quelles règles de validation s'y appliquent. Si l'on prend l'exemple d'un « produit » dans la boutique en ligne d'un magasin de vêtements, la composition des rubriques telles que le nom du produit, le prix, la description détaillée et la photo principale est régie par un unique Content Type « produit », et chaque produit réel est créé sous la forme d'un Content qui suit ce modèle.

Dans la CMA, un Content Type est une ressource enfant d'un Space, et son chemin se base sur /spaces/{spaceId}/content-types. Les opérations de gestion telles que la création, la modification et la dépublication s'effectuent dans la CMA, tandis que l'instantané publié est livré par la CDA. Toutefois, comme un Content Type est publié automatiquement lors de sa création et de sa modification, il passe immédiatement à l'état Published sans appel de publication distinct, contrairement à un Content (voir État et publication automatique ci-dessous).

Structure de la ressource

Voici la réponse à une consultation unitaire du Content Type « produit ». Outre sys (propriétés système), il possède des propriétés de corps telles que name, displayField, publishWithAuthor et fields.

{
  "sys": {
    "id": "3trmXRLdJF4GBlAjtcuoZ7Pnxj8dlA",
    "type": "ContentType",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "publish": {
      "version": 7,
      "at": "2026-06-17T03:13:49.973Z",
      "firstAt": "2026-06-14T17:04:46.953Z",
      "counter": 4,
      "by": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } }
    },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-14T17:04:46.846Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-17T03:13:49.973Z",
    "version": 8,
    "status": "Published"
  },
  "name": "Produit",
  "displayField": "productName",
  "publishWithAuthor": false,
  "fields": [
    { "id": "5n06s7ocmwdi", "name": "Nom du produit", "apiName": "productName", "type": "ShortText", "localized": true, "required": true, "validations": [], "disabled": false },
    { "id": "1gecyz8g4llwf", "name": "Prix", "apiName": "price", "type": "Long", "localized": false, "required": false, "validations": [], "disabled": false },
    { "id": "3ow4popgz54zg", "name": "Description", "apiName": "description", "type": "RichText", "localized": true, "required": false, "validations": [], "disabled": false },
    { "id": "2alxdptmdub1s", "name": "Photo", "apiName": "photo", "type": "Refer", "localized": false, "required": false, "validations": [], "disabled": false, "targetType": "Media" },
    {
      "id": "2a80lehazfx3t",
      "name": "Marque",
      "apiName": "brand",
      "type": "Refer",
      "localized": false,
      "required": false,
      "validations": [
        { "referContentType": [ { "sys": { "id": "3trmXRM3RqbgSnifyg7OveRYWnJWEG", "type": "Refer", "targetType": "ContentType" } } ] }
      ],
      "disabled": false,
      "targetType": "Content"
    }
  ]
}

Clés principales :

• sys.id : identifiant unique du Content Type. Il s'insère dans le {contentTypeId} des chemins de consultation unitaire, de modification et de suppression.
• name : nom du Content Type (par exemple Produit).
• displayField : apiName du champ qui représentera chaque Content dans la liste du studio de contenu (par exemple productName).
• publishWithAuthor : indique si les informations sur l'auteur (sys.createdBy et sys.updatedBy) sont incluses dans l'instantané de publication lors de la publication d'un Content. La valeur par défaut est false ; dans ce cas, l'instantané livré par la CDA/ACDA ne contient pas d'auteur. Cette valeur s'applique au moment de la publication et n'est pas rétroactive : même si vous la passez plus tard à true, les Content déjà publiés doivent être republiés pour que l'auteur y soit renseigné. Les brouillons que traitent les API de gestion (CMA/ACMA) possèdent sys.createdBy indépendamment de ce paramètre. Pour exposer l'auteur (byline) dans la réponse de distribution ou pour que le filtre createdBy des règles de permissions (y compris :self) soit évalué sur la CDA/ACDA, cette valeur doit être true (voir l'explication du filtre createdBy de SpaceRole et de ServiceUserRole).
• fields : liste des champs que ce modèle définit. La structure de chaque élément est décrite ci-dessous dans Champs.

Le champ photo a pour type la valeur Refer et pour targetType la valeur Media, il pointe donc vers un fichier téléversé. Le champ brand est de type Refer + targetType: Content, et grâce au referContentType de ses validations, il restreint la référence aux seuls Content d'un Content Type précis (ici « Marque »).

Propriétés système (sys)

Tout Content Type place dans l'objet sys des propriétés système communes ainsi que des propriétés propres au Content Type. space, createdBy et updatedBy se présentent sous la forme Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Clés de l'objet publish :

Lors d'une dépublication (DELETE .../publish), les clés version, at et by sont retirées de publish, et seules firstAt et counter subsistent.

Le sys d'un Content Type ne possède pas la propriété contentType (référence à soi-même) présente dans le sys d'un Content, parce que le Content Type est lui-même le modèle. Il ne possède pas non plus de propriété archive.

Champs

fields est la liste des champs que ce Content Type définit. Chaque élément a la structure suivante (FieldDefinition).

Types de champ (type)

type détermine la manière dont la valeur est stockée et consultée. Certains types ont un comportement de recherche différent.

Dans l'exemple « produit », Nom du produit est de type ShortText, Prix de type Long, Description de type RichText, Photo de type Refer (targetType: Media) et Marque de type Refer (targetType: Content).

Les limites de valeur sont les plafonds de la plateforme fixés par le type, et elles sont vérifiées au moment où l'on écrit une valeur dans un Content, et non lors de la création du Content Type. Même si vous indiquez un plafond plus élevé avec size dans validations, c'est le plafond de la plateforme qui s'applique en premier. Les éléments d'un Array sont soumis tels quels aux mêmes limites que leur type d'élément : dans un tableau dont items.type vaut ShortText, aucun élément ne peut donc dépasser 64 caractères. Si vous écrivez un Content avec une valeur qui dépasse la limite, l'écriture est refusée ; le code correspondant figure dans les erreurs du Content.

Validation (validations)

validations est le tableau des règles à appliquer à la valeur d'un champ. Chaque élément contient l'une des clés suivantes.

Valeurs utilisables dans mediaMimetypeGroup (12 au total) : Attachment, Plaintext, Image, Audio, Video, RichText, Presentation, Spreadsheet, PdfDocument, Archive, Code, Markup.

Le champ brand de l'exemple « produit » restreint la référence au seul Content Type « Marque » (dont le sys.id est 3trmXRM3RqbgSnifyg7OveRYWnJWEG) grâce à referContentType.

État et publication automatique

Un Content Type est publié automatiquement lors de sa création, de sa modification et de sa modification partielle. C'est en cela qu'il diffère d'un Content. Un Content n'entre dans le circuit de livraison qu'après un appel de publication distinct suivant sa création, alors que pour un Content Type la réponse à la création renvoie immédiatement status: "Published".

status prend l'une des 4 valeurs suivantes.

sys.version augmente de 1 à chaque changement. Comme la modification et la publication d'un Content Type se produisent en une seule fois, une seule modification fait monter version de 2 (la modification elle-même +1, la publication automatique +1). Dans l'exemple « Annonce », juste après la création version vaut 2 (création +1, publication automatique +1) et publish.counter vaut 1. Après une modification, version passe à 4 et publish.counter à 2.

Le seul moyen pour un Content Type de passer à Draft est une dépublication explicite (DELETE .../publish). Après une dépublication, status devient Draft, et dans l'objet publish les clés version, at et by disparaissent tandis que seules firstAt et counter subsistent.

Contraintes

Garde-fous de suppression : la suppression exige de satisfaire les deux conditions suivantes.

• S'il existe ne serait-ce qu'un Content qui utilise ce Content Type, la suppression est impossible. Supprimez d'abord tous les Content concernés. C'est cette vérification qui s'applique en premier.
• Un Content Type à l'état publié (Published ou Changed) ne peut pas être supprimé directement. Dépubliez-le d'abord (DELETE .../publish) pour le faire passer à Draft, puis supprimez-le (la suppression est également possible depuis l'état Archived).

Erreurs

Ce sont les codes que l'on rencontre lorsque l'on manipule un Content Type. Pour les codes communs à toutes les ressources, consultez Erreurs communes.

API

L'URL de base de tous les endpoints ci-dessous est https://cma.weegloo.com/v1, et un jeton Bearer authentifiant la CMA est requis dans l'en-tête Authorization. La modification, la modification partielle, la publication et la dépublication doivent également envoyer l'en-tête X-Weegloo-Version (le sys.version actuel de la ressource) pour le contrôle de concurrence optimiste.

Documents liés

• Modélisation de Content : comment créer un Content Type dans le studio de contenu.
• État et publication : la signification de la publication et des versions.