Content Type

La CDA (Content Delivery API) es una API de solo lectura que entrega los recursos publicados a los visitantes públicos. Esta página trata cómo consultar un Content Type publicado, es decir, el molde (esquema) que sigue un Content. Al leer con la CDA qué campos tiene ese molde y qué tipo, condición multilingüe, obligatoriedad y reglas de validación tiene cada campo, puede conocer de antemano la forma del Content publicado que sigue ese molde.

La CDA solo dispone de endpoints de consulta (GET); la tarea de crear, modificar y publicar un Content Type la realiza CMA Content Type. Para la autenticación y el modelo de entrega de publicación (instantánea de publicación, revision, solo se ve lo publicado) y demás comportamientos comunes de la CDA, consulte Visión general de la CDA. Como el Content Type es el esquema del molde, su consulta no acepta el parámetro locale.

Estructura del recurso

A continuación se muestra la forma en que la CDA entrega, mediante una consulta individual, el Content Type publicado "Producto" del Space de demostración. Junto con sys (propiedades de sistema), tiene propiedades de cuerpo como name, displayField, publishWithAuthor y fields.

{
  "sys": {
    "id": "3trmXRLdJF4GBlAjtcuoZ7Pnxj8dlA",
    "type": "ContentType",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "createdAt": "2026-06-14T17:04:46.846Z",
    "updatedAt": "2026-06-17T03:13:49.943Z",
    "revision": 7
  },
  "name": "Producto",
  "displayField": "productName",
  "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"
    }
  ],
  "publishWithAuthor": false
}

Claves principales:

• sys.id: identificador único del Content Type. Va en el {contentTypeId} de la ruta de consulta individual.
• sys.revision: la versión en el momento de la publicación. Como la CDA no incluye el version de gestión, el único valor que apunta a la versión publicada es revision.
• name: el nombre del Content Type (por ejemplo, Producto).
• displayField: el apiName del campo que representará a cada Content en la lista del estudio de contenidos (por ejemplo, productName).
• publishWithAuthor: indica si la información del autor se incluye al publicar un Content (en el ejemplo es false).
• fields: la lista de campos que define este molde. La estructura de cada elemento se explica más abajo en Campos.

Propiedades de sistema (sys)

El sys de un Content Type publicado contiene solo propiedades de la instantánea de publicación. space, createdBy y updatedBy entran con forma Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Al tratarse de una instantánea de publicación, no se incluyen version, status, publish ni archive, que sí están en el sys de la CMA. El único valor que apunta a la versión publicada es revision.

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 la forma en que 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 campo Marca se restringe, mediante referContentType en validations, a referenciar únicamente el Content de un Content Type concreto (aquí "Marca", con sys.id igual a 3trmXRM3RqbgSnifyg7OveRYWnJWEG).

El catálogo completo de claves de las reglas de validación que se pueden usar en validations está recopilado en CMA Content Type. La instantánea de publicación que entrega la CDA contiene también la misma estructura tal cual.

API

La URL base de los dos endpoints siguientes es https://cda.weegloo.com/v1, y se requiere en el encabezado Authorization un token Bearer que autentique en la CDA. Como el Content Type es un molde (esquema) y no es algo cuyo idioma se elija, a diferencia de la consulta de Content, no acepta el parámetro de consulta locale.

Documentos relacionados

• CMA Content Type: la API de gestión para crear y modificar Content Type (incluye la especificación completa de tipos de campo y validaciones).
• CDA Content: recibir el Content publicado que sigue este molde.
• Estados y publicación (concepto): el significado de la publicación y de las versiones.