CDA (Content Delivery API)

Última actualización: 3 de julio de 2026

La CDA (Content Delivery API) es una API de solo lectura que entrega Content, Media y otros recursos publicados a los visitantes. Cuando quien opera un Space crea y publica contenido desdel estudio de contenidos o mediante la CMA, los sitios web y las apps leen esa versión publicada a través de la CDA y la muestran en pantalla. La creación, la modificación y la publicación no corresponden a la CDA, sino a la CMA.

La URL base es https://cda.weegloo.com/v1. Para la autenticación se suele usar un DeliveryAccessToken de mínimo privilegio: un token que solo tiene el alcance necesario para ser seguro en la entrega pública a navegadores. También es posible leer con un Bearer token de Weegloo User, pero para la distribución en navegador tiene permisos excesivos, por lo que se recomienda el DeliveryAccessToken.

Comportamiento común

Lo siguiente se aplica a todos los recursos de la CDA. Cada página de recurso da por sentado este comportamiento y solo trata su contenido específico.

  • Solo lectura. Todos los endpoints son de consulta (GET). La escritura y la publicación corresponden a la CMA.

  • Solo se ve lo publicado. De Content, Media y Content Type solo se entrega la instantánea publicada. Los Draft de la CMA y los cambios sin publicar no aparecen en la CDA.

  • sys de la instantánea publicada. El sys de esos tres recursos no incluye version, status ni publish de gestión, sino únicamente revision, que apunta a la versión vigente en el momento de la publicación. (El recurso Locale no es objeto de publicación, sino un recurso de configuración, por lo que conserva su version.)

  • Selección de idioma con locale. Las consultas de Content y Media determinan en qué idioma se reciben mediante el parámetro de consulta locale. Funciona de tres maneras.

    • Si se indica un código como locale=ko-KR, se devuelve fields con un único valor de ese locale (no un mapa de locales). Si no hay valor y el Fallback tampoco alcanza, ese campo queda vacío o es null.
    • Si se omite, se devuelve de la misma forma con el Locale predeterminado del Space.
    • Si se indica locale=*, no se elige un solo idioma, sino que se devuelve tal cual un mapa con los valores de todos los locales ({ apiName: { locale: value } }).

    En los dos primeros casos, en los que se recibe un solo idioma, la respuesta incluye la cabecera x-weegloo-locale, que indica el locale realmente utilizado (no se incluye cuando locale=*). (El Content Type es el esquema de la plantilla, por lo que no admite locale, y Sync no elige idioma, sino que entrega tal cual el mapa de locales.)

  • Exposición del autor. Los campos createdBy y updatedBy de Content solo se entregan cuando publishWithAuthor de ese Content Type está activado. Media siempre omite la información del autor.

Recursos

  • Content Type: consulta los Content Type publicados (la plantilla del contenido y la definición de los campos).
  • Content: consulta los Content publicados en lista completa, de forma individual o por Content Type.
  • Media: consulta los Media publicados (archivos como recursos) y sus URL de entrega.
  • Locale: consulta la configuración de idiomas que admite el Space (code, si es el predeterminado y fallbackCode). Al ser un recurso de configuración, tiene version en sys.
  • Sync: sincronización incremental que solo recibe lo que ha cambiado o se ha eliminado desde la última sincronización. Los valores se entregan tal cual como mapa de locales y no se elige un solo idioma.
  • CMA Content Type: la API de gestión para crear, modificar y publicar la plantilla del contenido y el propio contenido.
  • ACDA: la versión que realiza la misma entrega con la identidad de un miembro (ServiceUser).