Content Type

Content Type es el molde (esquema) que sigue el contenido. Define qué campos tiene y, para cada campo, su tipo, si admite varios idiomas, si es obligatorio y qué reglas de validación aplica. Si tomamos el "producto" de una tienda de ropa como ejemplo, un único Content Type "producto" regula la composición de elementos como el nombre del producto, el precio, la descripción detallada y la foto principal, y cada producto concreto se crea como un Content que sigue este molde.

En CMA, Content Type es un recurso secundario de Space y su ruta se basa en /spaces/{spaceId}/content-types. Las operaciones de gestión como crear, modificar o anular la publicación se realizan en CMA, y la instantánea publicada se entrega a través de CDA. Sin embargo, Content Type se publica automáticamente al crearse o modificarse, por lo que, a diferencia de Content, pasa de inmediato al estado Published sin una llamada de publicación aparte (consulta Estado y publicación automática más abajo).

Estructura del recurso

A continuación se muestra la respuesta de consulta individual del Content Type "producto". Junto con sys (propiedades del sistema), incluye propiedades del cuerpo como name, displayField, publishWithAuthor y 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": "Producto",
  "displayField": "productName",
  "publishWithAuthor": false,
  "fields": [
    { "id": "5n06s7ocmwdi", "name": "Nombre del producto", "apiName": "productName", "type": "ShortText", "localized": true, "required": true, "validations": [], "disabled": false },
    { "id": "1gecyz8g4llwf", "name": "Precio", "apiName": "price", "type": "Long", "localized": false, "required": false, "validations": [], "disabled": false },
    { "id": "3ow4popgz54zg", "name": "Descripción", "apiName": "description", "type": "RichText", "localized": true, "required": false, "validations": [], "disabled": false },
    { "id": "2alxdptmdub1s", "name": "Foto", "apiName": "photo", "type": "Refer", "localized": false, "required": false, "validations": [], "disabled": false, "targetType": "Media" },
    {
      "id": "2a80lehazfx3t",
      "name": "Marca",
      "apiName": "brand",
      "type": "Refer",
      "localized": false,
      "required": false,
      "validations": [
        { "referContentType": [ { "sys": { "id": "3trmXRM3RqbgSnifyg7OveRYWnJWEG", "type": "Refer", "targetType": "ContentType" } } ] }
      ],
      "disabled": false,
      "targetType": "Content"
    }
  ]
}

Claves principales:

• sys.id: identificador único del Content Type. Va en {contentTypeId} de las rutas de consulta individual, modificación y eliminación.
• name: nombre del Content Type (por ejemplo, Producto).
• displayField: apiName del campo que representa cada Content en la lista del estudio de contenidos (por ejemplo, productName).
• publishWithAuthor: indica si la información del autor se incluye al publicar el Content. El valor por defecto es false.
• fields: lista de campos que define este molde. La estructura de cada elemento se describe en Campos más abajo.

El campo photo tiene type Refer y targetType Media, por lo que apunta a un archivo subido. El campo brand es Refer + targetType: Content y, mediante referContentType en validations, limita la referencia únicamente a los Content de un Content Type concreto (aquí, "Marca").

Propiedades del sistema (sys)

Todos los Content Type incluyen en el objeto sys las propiedades de sistema comunes y las propiedades propias de Content Type. space, createdBy y updatedBy van con forma Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Claves del objeto publish:

Al anular la publicación (DELETE .../publish), se eliminan version, at y by de publish y solo quedan firstAt y counter.

El sys de Content Type no tiene la propiedad contentType (autorreferencia) que sí está en el sys de Content, porque el propio Content Type es el molde. Tampoco tiene la propiedad archive.

Campos

fields es la lista de campos que define este Content Type. Cada elemento tiene la siguiente estructura (FieldDefinition).

Tipos de campo (type)

type determina cómo se almacena y consulta el valor. Algunos tipos tienen un comportamiento de búsqueda distinto.

En el ejemplo "producto", Nombre del producto es ShortText, Precio es Long, Descripción es RichText, Foto es Refer (targetType: Media) y Marca es Refer (targetType: Content).

Validaciones (validations)

validations es el array de reglas que se aplican al valor del campo. Cada elemento contiene una de las siguientes claves.

Valores admitidos en mediaMimetypeGroup (12 tipos): Attachment, Plaintext, Image, Audio, Video, RichText, Presentation, Spreadsheet, PdfDocument, Archive, Code, Markup.

El campo brand del ejemplo "producto" limita, mediante referContentType, la referencia únicamente al Content Type "Marca" (cuyo sys.id es 3trmXRM3RqbgSnifyg7OveRYWnJWEG).

Estado y publicación automática

Content Type se publica automáticamente al crearse, modificarse o modificarse parcialmente. En esto se diferencia de Content. Content solo entra en la ruta de entrega cuando hay una llamada de publicación aparte tras crearlo, pero la respuesta de creación de Content Type devuelve directamente status: "Published".

status es uno de los siguientes 4 valores.

sys.version aumenta en 1 con cada cambio. Como en Content Type la modificación y la publicación ocurren a la vez, una sola modificación sube version en 2 (la propia modificación +1, la publicación automática +1). En el ejemplo "Aviso", justo después de la creación version es 2 (creación +1, publicación automática +1) y publish.counter es 1. Si a continuación se modifica, version pasa a 4 y publish.counter pasa a 2.

La única vía por la que un Content Type pasa a Draft es la anulación de publicación explícita (DELETE .../publish). Al anular la publicación, status pasa a Draft y en el objeto publish se quitan version, at y by, quedando solo firstAt y counter.

Restricciones

Protección de eliminación: la eliminación debe cumplir ambas condiciones.

• No se puede eliminar si existe al menos un Content que use este Content Type (WGL422010). Elimina primero todos esos Content. Esta comprobación se aplica en primer lugar.
• Un Content Type en estado de publicación (Published, Changed) no se puede eliminar directamente (WGL422009). Anula primero la publicación (DELETE .../publish) para dejarlo en Draft y luego elimínalo (el estado Archived también permite eliminar).

API

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

Documentos relacionados

• Modelado de Content: cómo crear un Content Type en el estudio de contenidos.
• Estado y publicación: el significado de la publicación y las versiones.