Media

CDA (Content Delivery API) adalah API hanya-baca yang mengirimkan resource yang sudah dipublikasikan kepada pengunjung publik. Halaman ini membahas cara mengambil Media yang sudah dipublikasikan, yaitu aset berkas seperti gambar, video, dan dokumen, serta cara memperoleh alamat pengirimannya. CDA mengirimkan snapshot pada saat publikasi, sehingga Media yang belum dipublikasikan di studio konten tidak akan muncul di sini.

CDA hanya memiliki endpoint pengambilan (GET), sedangkan pekerjaan mengunggah, mengubah, dan mempublikasikan Media ditangani oleh CMA Media. Untuk perilaku umum CDA seperti autentikasi dan model pengiriman publikasi (snapshot publikasi, revision, hanya yang sudah dipublikasikan yang terlihat), lihat Ikhtisar CDA. Berbeda dengan resource publikasi lain, Media selalu menghilangkan informasi pembuat (createdBy, updatedBy). title, description, dan file dikembalikan sebagai satu nilai dari locale yang diambil (jika locale=*, dikembalikan sebagai peta lengkap).

Struktur resource

Berikut adalah bentuk yang dikirim CDA ketika satu Media publikasi dari Space demo (foto produk "스테인리스 텀블러 500ml") diambil secara tunggal dengan locale=ko-KR. Bersama sys (properti sistem), resource ini memiliki fields yang berisi title, description, dan file dari locale tersebut.

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

Kunci utama:

• sys.id: pengenal unik Media. Nilai ini masuk ke {mediaId} pada jalur pengambilan tunggal.
• sys.revision: versi pada saat dipublikasikan. CDA tidak menyertakan version untuk pengelolaan, sehingga nilai yang menunjuk versi publikasi hanya revision.
• fields.title, fields.description: satu nilai dari locale yang diminta (bukan peta locale).
• fields.file: objek yang merepresentasikan satu berkas dari locale tersebut. Alamat pengiriman untuk menampilkan berkas kepada pengunjung adalah file.url. Kunci objek ini dijelaskan pada fields di bawah.

Properti sistem (sys)

sys dari Media publikasi hanya berisi properti untuk snapshot publikasi. space masuk dalam bentuk Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Karena ini adalah snapshot publikasi, version, status, publish, dan archive yang ada di sys pada CMA tidak disertakan. Satu-satunya nilai yang menunjuk versi publikasi adalah revision. Informasi pembuat (createdBy, updatedBy) juga selalu dihilangkan dari respons pengiriman.

fields

fields berisi satu nilai dari locale yang diminta. Berbeda dengan CMA yang mengembalikan peta berisi semua nilai per locale seperti fields.title.ko-KR, CDA memilih satu nilai dari locale yang diminta dan langsung memasukkannya.

Kunci objek file adalah sebagai berikut.

API

Base URL kedua endpoint di bawah adalah https://cda.weegloo.com/v1, dan diperlukan token Bearer yang mengautentikasi CDA pada header Authorization. Kedua endpoint menentukan bahasa yang diterima melalui parameter kueri locale. Jika diberi kode seperti locale=ko-KR, dikembalikan dengan nilai locale tersebut; jika dihilangkan, dengan Locale default Space; jika locale=*, dengan peta locale lengkap. Pada dua kasus pertama, disertakan header x-weegloo-locale yang memberi tahu locale yang sebenarnya dipakai.

Dokumen terkait

• CDA Content: Content publikasi yang mereferensikan Media.
• CMA Media: API untuk mengunggah dan mengelola Media.
• Media (konsep): cara menangani aset berkas di studio konten.