Media

La CDA (Content Delivery API) est une API en lecture seule qui distribue les ressources publiées aux visiteurs publics. Cette page traite de la façon de consulter des Media publiés, c'est-à-dire des fichiers d'actifs comme les images, les vidéos ou les documents, et d'en récupérer l'adresse de distribution. La CDA distribue l'instantané pris au moment de la publication ; un Media qui n'a pas encore été publié dans le studio de contenu n'apparaît donc pas ici.

La CDA ne comporte que des points de terminaison de consultation (GET) ; le téléversement, la modification et la publication d'un Media relèvent de CMA Media. Pour les comportements communs à la CDA comme l'authentification et le modèle de distribution par publication (instantané de publication, revision, seuls les éléments publiés sont visibles), reportez-vous à l'aperçu de la CDA. Contrairement aux autres ressources publiées, un Media omet toujours les informations d'auteur (createdBy et updatedBy). Les champs title, description et file sont renvoyés sous forme d'une valeur unique correspondant au locale consulté (la carte complète si locale=*).

Structure de la ressource

Voici la forme qu'un Media publié de la Space de démonstration (la photo du produit « 스테인리스 텀블러 500ml ») prend lorsque la CDA le distribue par une consultation unitaire avec locale=ko-KR. Avec sys (propriétés système), il comporte un objet fields contenant les title, description et file de ce 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 }
      }
    }
  }
}

Clés principales :

• sys.id : identifiant unique du Media. Il s'insère dans le {mediaId} du chemin de consultation unitaire.
• sys.revision : version au moment de la publication. La CDA ne contient pas le version de gestion ; la seule valeur qui désigne la version publiée est revision.
• fields.title et fields.description : une valeur unique pour le locale demandé (ce n'est pas une carte de locales).
• fields.file : objet représentant un fichier unique pour ce locale. L'adresse de distribution qui sert le fichier au visiteur est file.url. Les clés de l'objet sont décrites dans la section fields ci-dessous.

Propriétés système (sys)

Le sys d'un Media publié ne contient que les propriétés relatives à l'instantané de publication. Le champ space se présente sous la forme Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Comme il s'agit d'un instantané de publication, les version, status, publish et archive présents dans le sys de la CMA n'y figurent pas. La seule valeur qui désigne la version publiée est revision. Les informations d'auteur (createdBy et updatedBy) sont elles aussi toujours omises dans la réponse de distribution.

fields

fields contient une valeur unique pour le locale demandé. Là où la CMA renvoie une carte regroupant toutes les valeurs par locale (par exemple fields.title.ko-KR), la CDA sélectionne la valeur du seul locale demandé et l'insère directement.

Les clés de l'objet file sont les suivantes.

API

L'URL de base des deux points de terminaison ci-dessous est https://cda.weegloo.com/v1, et l'en-tête Authorization doit comporter un jeton Bearer qui authentifie auprès de la CDA. Les deux points de terminaison déterminent la langue à recevoir au moyen du paramètre de requête locale. Si vous fournissez un code comme locale=ko-KR, vous obtenez la valeur de ce locale ; si vous l'omettez, le Locale par défaut de la Space ; et avec locale=*, la carte complète des locales. Dans les deux premiers cas, l'en-tête x-weegloo-locale est joint pour indiquer le locale réellement utilisé.

Documents associés

• CDA Content : le Content publié qui référence un Media.
• CMA Media : l'API de téléversement et de gestion des Media.
• Media (concept) : comment manipuler les fichiers d'actifs dans le studio de contenu.