Tag

Un Tag es una etiqueta corta que clasifica Content o Media. Tomando como ejemplo una tienda de ropa online, etiquetas como "Más vendidos" o "Novedades" son Tag. Si asignas el mismo Tag a varios Content y Media, después puedes agruparlos o filtrarlos por esa etiqueta.

El Tag en sí es una etiqueta que solo tiene un nombre (name); es un recurso de configuración sin concepto de publicación. Asignarlo a algo no consiste en modificar el Tag directamente, sino en añadir el Refer de ese Tag a metadata.tags del Content o Media (consulta Etiquetar content y media más abajo). En CMA, un Tag es un recurso subordinado de Space, y su ruta se basa en /spaces/{spaceId}/tags.

Estructura del recurso

A continuación se muestra la respuesta de consulta individual del Tag "Más vendidos". Tiene sys (propiedades del sistema) y la propiedad de cuerpo 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": "Más vendidos"
}

Claves principales:

• sys.id: identificador único del Tag. Se usa en {tagId} de las rutas de consulta individual, modificación y eliminación, y también como id de destino del Refer al etiquetar mediante metadata.tags.
• name: nombre del Tag (1-16 caracteres). Es la etiqueta misma que aparece en la clasificación de contenido.

Propiedades del sistema (sys)

Todos los Tag contienen propiedades del sistema comunes en el objeto sys. space, createdBy y updatedBy se incluyen con la forma Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Propiedad de cuerpo:

Un Tag es un recurso de configuración sin concepto de publicación. Por eso, a diferencia de Content y Media, su sys no tiene publish, archive ni status, solo version. La version aumenta cada vez que se modifica el Tag.

Etiquetar content y media

Para asignar un Tag hay que seguir dos pasos.

1. Crea el Tag (endpoint Crear Tag más abajo). Guarda el sys.id de la respuesta.
2. Al crear o modificar el Content o Media, añade el Refer de este Tag al array metadata.tags de su cuerpo.

La forma del Refer que se añade a metadata.tags es la siguiente. En id se pone el sys.id del Tag obtenido en el paso 1.

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

Para asignar varios Tag, añade varios de estos objetos Refer al array. Para quitar una etiqueta, elimina el elemento correspondiente del array y vuelve a modificar el Content o Media. Para conocer en detalle cómo redactar los datos de cuerpo de Content y Media, consulta los documentos Content y Media.

API

La URL base de todos los endpoints siguientes es https://cma.weegloo.com/v1, y requieren un token Bearer que autentique en CMA en la cabecera Authorization. Para la modificación y la modificación parcial debes enviar también la cabecera X-Weegloo-Version (el sys.version actual del recurso) para el control de concurrencia optimista. La creación y la eliminación no llevan esta cabecera.

Documentos relacionados

• Content: datos de cuerpo para etiquetar con Tag mediante metadata.tags.
• Media: recurso de archivo para etiquetar con Tag mediante metadata.tags.