Content

Die CDA (Content Delivery API) ist eine schreibgeschützte API, die veröffentlichte Ressourcen an öffentliche Besucher ausliefert. Diese Seite behandelt, wie veröffentlichtes Content, also einzelne tatsächliche Datensätze, die nach der Vorlage eines Content Type erstellt wurden, abgefragt wird. Die CDA liefert eine Momentaufnahme zum Zeitpunkt der Veröffentlichung aus, weshalb im Content-Studio noch nicht veröffentlichte Arbeitsstände hier nicht erscheinen.

Die CDA verfügt ausschließlich über Abfrage-Endpunkte (GET); das Erstellen, Bearbeiten und Veröffentlichen von Content übernimmt CMA Content. Gemeinsame CDA-Verhaltensweisen wie Authentifizierung und das Auslieferungsmodell für veröffentlichte Inhalte (Veröffentlichungs-Momentaufnahme, revision, nur Veröffentlichtes ist sichtbar, die Offenlegung des Autors hängt von publishWithAuthor ab) finden Sie in der CDA-Übersicht. Wie Sie mit locale die zu empfangende Sprache festlegen, behandelt der Abschnitt locale und fields weiter unten.

Ressourcenstruktur

Im Folgenden sehen Sie das Format, in dem die CDA einen veröffentlichten Content-Datensatz des Demo-Space (Produkt "스테인리스 텀블러 500ml") als Einzelabfrage mit locale=ko-KR ausliefert. Neben sys (Systemeigenschaften) enthält er fields, das die Feldwerte des Content Type, dem dieses Content folgt, aufnimmt.

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7OGhwhlqvAvq",
    "type": "Content",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "contentType": { "sys": { "id": "3trmXRLdJF4GBlAjtcuoZ7Pnxj8dlA", "type": "Refer", "targetType": "ContentType" } },
    "createdAt": "2026-06-15T15:16:12.151Z",
    "updatedAt": "2026-06-16T14:31:20.073Z",
    "revision": 3
  },
  "fields": {
    "price": 18000,
    "description": "이중 진공 단열로 보온·보냉이 오래갑니다. 500ml 대용량.",
    "photo": null,
    "productName": "스테인리스 텀블러 500ml"
  }
}

Wichtigste Schlüssel:

• sys.id: Der eindeutige Bezeichner des Content. Er wird in den {contentId}-Teil des Pfads für die Einzelabfrage eingesetzt.
• sys.contentType: Ein Refer, das auf den Content Type (die Vorlage) verweist, dem dieses Content folgt. sys.id ist der Bezeichner dieses Content Type; welche Felder er besitzt, lässt sich in CDA Content Type nachlesen.
• sys.revision: Die Version zum Zeitpunkt der Veröffentlichung. Da die CDA das verwaltungsbezogene version nicht enthält, ist revision der einzige Wert, der auf die veröffentlichte Version verweist.
• fields: Ein Objekt, dessen Schlüssel jeweils der apiName eines Felds des Content Type ist. Der Wert ist der eine Wert der angeforderten locale (keine Locale-Map). Das photo im obigen Beispiel ist null, weil kein Media verknüpft ist.

Systemeigenschaften (sys)

Das sys eines veröffentlichten Content enthält ausschließlich Eigenschaften für die Veröffentlichungs-Momentaufnahme. space, contentType, createdBy und updatedBy liegen in der Refer-Form ({ "sys": { "id", "type": "Refer", "targetType" } }) vor.

Da es sich um eine Veröffentlichungs-Momentaufnahme handelt, werden version, status, publish und archive aus dem sys der CMA hier nicht aufgenommen. Der einzige Wert, der auf die veröffentlichte Version verweist, ist revision.

locale und fields

Mit dem Abfrageparameter locale legen Sie fest, in welcher Sprache Sie die Daten empfangen. Es gibt drei Verhaltensweisen.

• Geben Sie einen Code wie locale=ko-KR an, werden fields mit dem einen Wert dieser Locale zurückgegeben. Anders als die CMA, die eine Map mit allen Werten je Locale zurückgibt (etwa fields.productName.ko-KR), wählt die CDA den Wert der einen angeforderten Locale aus und legt ihn direkt in fields.productName ab. Liegt kein Wert vor und greift auch kein Fallback, ist dieses Feld null (dass photo in der obigen Ressourcenstruktur null ist, liegt daran, dass kein Media verknüpft ist).
• Lassen Sie locale weg, wird auf dieselbe Weise mit der Standard-Locale des Space zurückgegeben.
• Geben Sie locale=* an, wird keine einzelne Sprache ausgewählt; stattdessen wird wie bei der CMA eine Map mit allen Werten je Locale (fields.productName.ko-KR) unverändert zurückgegeben.

Wenn Sie über einen Code oder durch Weglassen eine einzelne Sprache empfangen, enthält die Antwort den Header x-weegloo-locale, der die tatsächlich verwendete Locale angibt (bei locale=* wird er nicht mitgeliefert). Die Auswahl der Locale-Werte und die Fallback-Regeln behandelt Mehrsprachigkeit (Konzept).

API

Die Basis-URL der vier folgenden Endpunkte lautet https://cda.weegloo.com/v1, und im Header Authorization ist ein Bearer-Token erforderlich, das die CDA authentifiziert. Alle vier Endpunkte akzeptieren den Abfrageparameter locale (siehe locale und fields oben). Die ersten beiden Endpunkte beziehen sich auf das gesamte veröffentlichte Content eines Space, die letzten beiden nur auf Content, das zu einem bestimmten Content Type gehört.

Wenn Sie die ersten beiden Endpunkte (die Space-weite flache Liste) nach fields.* filtern oder sortieren, müssen Sie sie zusätzlich mit sys.contentType.sys.id={contentTypeId} auf einen Content Type eingrenzen. Ein bloßes contentType={contentTypeId} ersetzt dies nicht. Die letzten beiden Endpunkte tragen den Content Type bereits im Pfad, sodass dies dort nicht nötig ist.

Verwandte Dokumente

• CDA Content Type: Die veröffentlichte Vorlage, der dieses Content folgt.
• CDA Media: Die veröffentlichten Datei-Assets, auf die Content verweist.
• CMA Content: Die Verwaltungs-API zum Erstellen und Bearbeiten von Content.
• Mehrsprachigkeit (Konzept): locale- und fallback-Verhalten.