Media

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 sobre cómo consultar los Media publicados, es decir, recursos de archivo como imágenes, vídeos o documentos, y cómo obtener su dirección de entrega. Como la CDA entrega una instantánea del momento de la publicación, los Media que aún no se han publicado en el estudio de contenidos no aparecen aquí.

La CDA solo tiene endpoints de consulta (GET); las operaciones de subir, modificar y publicar Media las gestiona la CMA Media. Para los comportamientos comunes de la CDA, como la autenticación y el modelo de entrega por publicación (instantánea de publicación, revision, solo se ve lo publicado), consulta la Introducción a la CDA. A diferencia de otros recursos publicados, los Media siempre omiten la información de autoría (createdBy y updatedBy). Los campos title, description y file se devuelven con un único valor del locale consultado (con locale=* se devuelve el mapa completo).

Estructura del recurso

A continuación se muestra la forma en que la CDA entrega un Media publicado del Space de demostración (la foto del producto "스테인리스 텀블러 500ml"), consultado de forma individual con locale=ko-KR. Junto con sys (propiedades del sistema), tiene un fields que contiene el title, description y file de ese locale.

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7OGjUMsPV3uU",
    "type": "Media",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "createdAt": "2026-06-15T15:17:30.589Z",
    "updatedAt": "2026-06-15T15:17:30.810Z",
    "revision": 1
  },
  "fields": {
    "title": "스테인리스 텀블러 500ml 정면 컷",
    "description": "흰 배경에서 찍은 텀블러 정면 제품 사진입니다.",
    "file": {
      "fileName": "tumbler.png",
      "contentType": "image/png",
      "mimeGroups": ["Image"],
      "url": "https://weegloo-media.com/medias/HnQ32YiH/3uU/3trmXRM3RqbgSnifyg7OGjUMsPV3uU/ko-KR/1/tumbler.png",
      "detail": {
        "size": 50847,
        "image": { "width": 900, "height": 900 }
      }
    }
  }
}

Claves principales:

• sys.id: identificador único del Media. Es lo que va en el {mediaId} de la ruta de consulta individual.
• sys.revision: la versión del momento en que se hizo público. Como la CDA no incluye el version de gestión, el único valor que apunta a la versión publicada es revision.
• fields.title y fields.description: un único valor del locale solicitado (no es un mapa de locales).
• fields.file: un objeto que representa un único archivo de ese locale. La dirección de entrega para mostrar el archivo al visitante es file.url. Las claves del objeto se describen más abajo en fields.

Propiedades del sistema (sys)

El sys de un Media publicado solo contiene las propiedades de la instantánea de publicación. El campo space se incluye con la forma Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Al ser una instantánea de publicación, no se incluyen los campos version, status, publish ni archive que tiene el sys de la CMA. El único valor que apunta a la versión publicada es revision. La información de autoría (createdBy y updatedBy) también se omite siempre en la respuesta de entrega.

fields

fields contiene un único valor del locale solicitado. A diferencia de la CMA, que devuelve un mapa con todos los valores por locale como fields.title.ko-KR, la CDA selecciona el valor del único locale solicitado y lo coloca directamente.

Las claves del objeto file son las siguientes.

API

La URL base de los dos endpoints siguientes es https://cda.weegloo.com/v1, y se requiere un token Bearer que autentique la CDA en la cabecera Authorization. Ambos endpoints determinan el idioma a recibir mediante el parámetro de consulta locale. Si se da un código como locale=ko-KR, se devuelve con el valor de ese locale; si se omite, con el Locale predeterminado del Space; y con locale=*, con el mapa completo de locales. En los dos primeros casos se incluye la cabecera x-weegloo-locale, que indica el locale usado realmente.

Documentos relacionados

• CDA Content: el Content publicado que referencia los Media.
• CMA Media: la API para subir y gestionar los Media.
• Media (concepto): cómo manejar recursos de archivo en el estudio de contenidos.