Tag

Un Tag est une courte étiquette qui sert à classer un Content ou un Media. Pour une boutique de vêtements en ligne, des étiquettes comme « Top des ventes » ou « Nouveautés » sont des Tag. En apposant un même Tag à plusieurs Content ou Media, vous pouvez ensuite les regrouper ou les filtrer à partir de cette étiquette.

Un Tag en soi est une étiquette qui ne possède qu'un nom (name) ; c'est une ressource de configuration sans notion de publication. Apposer concrètement un Tag à quelque chose ne consiste pas à modifier le Tag lui-même, mais à insérer le Refer de ce Tag dans le champ metadata.tags du Content ou du Media (voir Apposer un tag à un contenu ou un média ci-dessous). Sur la CMA, un Tag est une ressource sous-jacente à un Space, et son chemin se base sur /spaces/{spaceId}/tags.

Structure de la ressource

Voici la réponse d'une consultation unitaire du Tag « Top des ventes ». Il possède sys (propriétés système) et la propriété de corps name.

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7OShPt8M8Nwh",
    "type": "Tag",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-16T01:46:07.426Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-16T01:46:07.426Z",
    "version": 1
  },
  "name": "Top des ventes"
}

Clés principales :

• sys.id : l'identifiant unique du Tag. Il s'insère dans le {tagId} des chemins de consultation unitaire, de modification et de suppression, et sert aussi d'id cible du Refer lorsqu'on appose un tag via metadata.tags.
• name : le nom du Tag (1 à 16 caractères). C'est l'étiquette elle-même qui apparaît dans le classement des contenus.

Propriétés système (sys)

Chaque Tag regroupe les propriétés système communes dans l'objet sys. space, createdBy et updatedBy se présentent sous la forme Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Propriété de corps :

Un Tag est une ressource de configuration sans notion de publication. C'est pourquoi, contrairement à un Content ou un Media, son sys ne comporte pas publish, archive ni status, et ne possède que version. La version augmente à chaque modification du Tag.

Apposer un tag à un contenu ou un média

Apposer un Tag se fait en deux étapes.

1. Créez un Tag (endpoint Créer un Tag ci-dessous). Conservez le sys.id de la réponse.
2. Lors de la création ou de la modification d'un Content ou d'un Media, insérez le Refer de ce Tag dans le tableau metadata.tags de son corps.

Le Refer à insérer dans metadata.tags se présente comme suit. Dans id, placez le sys.id du Tag obtenu à l'étape 1.

"metadata": {
  "tags": [
    { "sys": { "id": "3trmXRM3RqbgSnifyg7OShPt8M8Nwh", "type": "Refer", "targetType": "Tag" } }
  ]
}

Pour apposer plusieurs Tag, insérez plusieurs de ces objets Refer dans le tableau. Pour retirer un tag, supprimez l'élément correspondant du tableau et modifiez à nouveau le Content ou le Media. Pour la méthode détaillée de rédaction des données de corps d'un Content ou d'un Media, reportez-vous aux documents Content et Media.

API

L'URL de base de tous les endpoints ci-dessous est https://cma.weegloo.com/v1, et l'en-tête Authorization doit contenir un token Bearer authentifiant la CMA. Pour la modification et la modification partielle, l'en-tête X-Weegloo-Version (la sys.version actuelle de la ressource) doit être envoyé conjointement afin d'assurer le contrôle de concurrence optimiste. Cet en-tête est absent pour la création et la suppression.

Documents associés

• Content : les données de corps qui apposent un Tag via metadata.tags.
• Media : la ressource fichier qui appose un Tag via metadata.tags.