Media

CDA(Content Delivery API)は、公開されたリソースを一般の閲覧者に配信する読み取り専用 API です。このページでは、公開された Media、つまり画像・動画・ドキュメントなどのファイルアセットを照会し、その配信アドレスを取得する方法を扱います。CDA は公開時点のスナップショットを配信するため、コンテンツスタジオでまだ公開していない Media はここには現れません。

CDA には照会(GET)エンドポイントのみがあり、Media をアップロード・編集・公開する操作は CMA Media が担当します。認証や公開配信モデル(公開スナップショット・revision・公開されたものだけが見える)などの CDA 共通動作は CDA 概要を参照してください。Media は他の公開リソースと異なり、作成者情報(createdBy・updatedBy)を常に省略します。title・description・file は照会した locale の値ひとつとして返ります(locale=* なら全体マップ)。

リソース構造

以下は、デモ Space の公開 Media 1 件(「스테인리스 텀블러 500ml」商品写真)を CDA が locale=ko-KR で単一照会して配信する形です。sys(システム属性)とともに、そのロケールの title・description・file を収めた fields を持ちます。

{
  "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 }
      }
    }
  }
}

主なキー:

• sys.id: Media の一意な識別子です。単一照会パスの {mediaId} に入ります。
• sys.revision: 公開された時点のバージョンです。CDA は管理用の version を含まないため、公開バージョンを指す値は revision のみです。
• fields.title・fields.description: 要求した locale の値ひとつです(ロケールマップではありません)。
• fields.file: そのロケールのファイル 1 個を表すオブジェクトです。閲覧者にファイルを表示するための配信アドレスは file.url です。オブジェクトのキーは下の fields で説明します。

システム属性 (sys)

公開 Media の sys は公開スナップショット用の属性のみを含みます。space は Refer の形({ "sys": { "id", "type": "Refer", "targetType" } })で入ります。

公開スナップショットのため、CMA の sys にある version・status・publish・archive は含まれません。公開バージョンを指す値は revision のみです。作成者情報(createdBy・updatedBy)も配信レスポンスでは常に省略されます。

fields

fields は要求した locale の値ひとつを収めます。CMA が fields.title.ko-KR のようにロケールごとの値をすべて収めたマップを返すのとは異なり、CDA は要求したロケールひとつの値を選んでそのまま入れて返します。

file オブジェクトのキーは次のとおりです。

API

以下の 2 つのエンドポイントのベース URL は https://cda.weegloo.com/v1 で、Authorization ヘッダーに CDA を認証する Bearer トークンが必要です。両エンドポイントとも locale クエリパラメータで受け取る言語を指定します。locale=ko-KR のようにコードを与えるとそのロケールの値で、省略すると Space の基本 Locale で、locale=* なら全体ロケールマップで返します。前者 2 つの場合は、実際に使ったロケールを知らせる x-weegloo-locale ヘッダーが付きます。

関連ドキュメント

• CDA Content: Media を参照する公開 Content。
• CMA Media: Media をアップロードして管理する API。
• Media (概念): ファイルアセットをコンテンツスタジオで扱う方法。