Content Type

Content Type es la plantilla (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 esta plantilla.

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, al publicar el Content, la instantánea de publicación incluye también la información del autor (sys.createdBy y sys.updatedBy). El valor por defecto es false, en cuyo caso la instantánea que se entrega a CDA/ACDA no incluye el autor. Este valor se aplica en el momento de la publicación y no es retroactivo, por lo que, aunque más adelante lo cambies a true, los Content ya publicados deben publicarse de nuevo para que se rellene el autor. Los borradores que gestionan las API de gestión (CMA/ACMA) tienen sys.createdBy con independencia de esta opción. Para exponer el autor (byline) en la respuesta de entrega o para evaluar en CDA/ACDA el filtro createdBy (incluido :self) de las reglas de permisos, hay que dejar este valor en true (consulta la descripción del filtro createdBy de SpaceRole y ServiceUserRole).
• fields: lista de campos que define esta plantilla. 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 la plantilla. 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).

El límite de valor es el tope de plataforma que fija el tipo, y no se comprueba al crear el Content Type, sino al escribir el valor en un Content. Aunque indiques un tope mayor con size en validations, se aplica antes el tope de plataforma. A los elementos de un Array se les aplica igualmente el límite del tipo del elemento, así que en un array cuyo items.type es ShortText ningún elemento puede superar los 64 caracteres. Si escribes en un Content un valor que supera el límite, la petición se rechaza, y el código está en Errores de 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. 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. Anula primero la publicación (DELETE .../publish) para dejarlo en Draft y luego elimínalo (el estado Archived también permite eliminar).

Errores

Códigos que se encuentran al trabajar con Content Type. Para los códigos comunes a todos los recursos, consulta Errores comunes.

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.