Media

A CDA (Content Delivery API) é uma API somente leitura que entrega os recursos publicados aos visitantes públicos. Esta página trata de como consultar uma Media publicada, ou seja, arquivos de mídia como imagens, vídeos e documentos, e obter o endereço de entrega correspondente. A CDA entrega o snapshot do momento da publicação, portanto uma Media que ainda não foi publicada no estúdio de conteúdo não aparece aqui.

A CDA tem apenas endpoints de consulta (GET); as operações de enviar, editar e publicar uma Media ficam a cargo da CMA Media. Para o comportamento comum da CDA, como autenticação e o modelo de entrega por publicação (snapshot de publicação, revision, apenas o que foi publicado fica visível), consulte a Visão geral da CDA. Diferentemente de outros recursos publicados, a Media sempre omite as informações de autor (createdBy, updatedBy). title, description e file retornam como um único valor do locale consultado (se locale=*, retornam o mapa completo).

Estrutura do recurso

A seguir está o formato em que a CDA entrega uma Media publicada da Space de demonstração (a foto do produto "스테인리스 텀블러 500ml") em uma consulta única com locale=ko-KR. Junto com sys (propriedades de sistema), ela tem fields, que contém o title, a description e o file daquele 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 }
      }
    }
  }
}

Chaves principais:

• sys.id: identificador único da Media. Entra no {mediaId} do caminho de consulta única.
• sys.revision: a versão no momento em que foi tornada pública. A CDA não inclui a version de gerenciamento, portanto o único valor que aponta para a versão publicada é revision.
• fields.title, fields.description: um único valor do locale solicitado (não é um mapa de locales).
• fields.file: objeto que representa o arquivo único daquele locale. O endereço de entrega que exibe o arquivo ao visitante é file.url. As chaves do objeto são descritas abaixo em fields.

Propriedades de sistema (sys)

O sys de uma Media publicada contém apenas as propriedades do snapshot de publicação. space entra no formato Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Por ser um snapshot de publicação, version, status, publish e archive, que existem no sys da CMA, não são incluídos. O único valor que aponta para a versão publicada é revision. As informações de autor (createdBy, updatedBy) também são sempre omitidas na resposta de entrega.

fields

fields contém um único valor do locale solicitado. Diferentemente da CMA, que retorna um mapa com todos os valores por locale como fields.title.ko-KR, a CDA seleciona o valor de um único locale solicitado e o insere diretamente.

As chaves do objeto file são as seguintes.

API

A URL base dos dois endpoints abaixo é https://cda.weegloo.com/v1, e é necessário um token Bearer que autentique a CDA no cabeçalho Authorization. Ambos os endpoints definem o idioma a receber pelo parâmetro de consulta locale. Se você informar um código como locale=ko-KR, retorna com o valor daquele locale; se omitir, retorna com o Locale padrão da Space; se locale=*, retorna o mapa completo de locales. Nos dois primeiros casos, vai incluído o cabeçalho x-weegloo-locale, que informa qual locale foi efetivamente usado.

Documentos relacionados

• CDA Content: Content publicado que referencia uma Media.
• CMA Media: API para enviar e gerenciar Media.
• Media (conceito): como lidar com arquivos de mídia no estúdio de conteúdo.