Media

Die CDA (Content Delivery API) ist eine schreibgeschützte API, die veröffentlichte Ressourcen an öffentliche Besucher ausliefert. Diese Seite behandelt, wie veröffentlichte Media, also Dateibestände wie Bilder, Videos und Dokumente, abgerufen werden und wie man ihre Auslieferungsadresse erhält. Da die CDA den Snapshot zum Zeitpunkt der Veröffentlichung ausliefert, erscheinen Media, die im Content-Studio noch nicht veröffentlicht wurden, hier nicht.

Die CDA verfügt nur über Abruf-Endpunkte (GET); das Hochladen, Bearbeiten und Veröffentlichen von Media übernimmt CMA Media. Für Authentifizierung, das Auslieferungsmodell veröffentlichter Inhalte (Veröffentlichungs-Snapshot, revision, nur Veröffentlichtes ist sichtbar) und weiteres gemeinsames CDA-Verhalten siehe die CDA-Übersicht. Anders als andere veröffentlichte Ressourcen lassen Media die Autoreninformationen (createdBy, updatedBy) immer weg. title, description und file werden als einzelner Wert der abgefragten locale zurückgegeben (bei locale=* als vollständige Map).

Ressourcenstruktur

Im Folgenden sehen Sie, wie die CDA ein veröffentlichtes Media des Demo-Space (ein Produktfoto von "스테인리스 텀블러 500ml") bei einer Einzelabfrage mit locale=ko-KR ausliefert. Neben sys (Systemeigenschaften) enthält es ein fields-Objekt mit title, description und file dieser 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 }
      }
    }
  }
}

Wichtigste Schlüssel:

• sys.id: Eindeutiger Bezeichner des Media. Er wird im {mediaId}-Segment des Einzelabfragepfads eingesetzt.
• sys.revision: Die Version zum Zeitpunkt der Veröffentlichung. Da die CDA die verwaltungsbezogene version nicht enthält, ist revision der einzige Wert, der die veröffentlichte Version angibt.
• fields.title, fields.description: Ein einzelner Wert der angefragten locale (keine Locale-Map).
• fields.file: Ein Objekt, das die eine Datei dieser Locale darstellt. Die Auslieferungsadresse, unter der die Datei dem Besucher angezeigt wird, ist file.url. Die Objektschlüssel werden unten unter fields beschrieben.

Systemeigenschaften (sys)

Das sys eines veröffentlichten Media enthält nur Eigenschaften für den Veröffentlichungs-Snapshot. space erscheint in der Refer-Form ({ "sys": { "id", "type": "Refer", "targetType" } }).

Da es sich um einen Veröffentlichungs-Snapshot handelt, sind die im sys der CMA enthaltenen Felder version, status, publish und archive nicht enthalten. Der einzige Wert, der die veröffentlichte Version angibt, ist revision. Auch die Autoreninformationen (createdBy, updatedBy) werden in der Auslieferungsantwort immer weggelassen.

fields

fields enthält einen einzelnen Wert der angefragten locale. Anders als die CMA, die eine Map mit allen werten je Locale zurückgibt (etwa fields.title.ko-KR), wählt die CDA den Wert der einen angefragten Locale aus und fügt ihn direkt ein.

Das file-Objekt hat folgende Schlüssel.

API

Die Basis-URL der beiden folgenden Endpunkte ist https://cda.weegloo.com/v1, und im Authorization-Header ist ein Bearer-Token zur Authentifizierung an der CDA erforderlich. Beide Endpunkte bestimmen über den Query-Parameter locale die auszuliefernde Sprache. Geben Sie einen Code wie locale=ko-KR an, wird der Wert dieser Locale zurückgegeben; lassen Sie ihn weg, die Standard-Locale des Space; bei locale=* die vollständige Locale-Map. In den ersten beiden Fällen wird der Header x-weegloo-locale mitgeliefert, der die tatsächlich verwendete Locale angibt.

Verwandte Dokumente

• CDA Content: Veröffentlichte Content, die Media referenzieren.
• CMA Media: API zum Hochladen und Verwalten von Media.
• Media (Konzept): Umgang mit Dateibeständen im Content-Studio.