Content Type

Die CDA (Content Delivery API) ist eine schreibgeschützte API, die veröffentlichte Ressourcen an öffentliche Besucher ausliefert. Diese Seite behandelt, wie ein veröffentlichter Content Type abgefragt wird, also das Schema (die Vorlage), dem ein Content folgt. Wenn Sie über die CDA auslesen, welche Felder diese Vorlage besitzt und welchen Typ, welche Mehrsprachigkeit, welche Pflichtangabe und welche Validierungsregeln jedes Feld hat, können Sie die Gestalt der veröffentlichten Content-Einträge, die dieser Vorlage folgen, im Voraus erkennen.

Die CDA besitzt nur Abfrage-Endpunkte (GET); das Erstellen, Bearbeiten und Veröffentlichen eines Content Type übernimmt CMA Content Type. Für gemeinsame CDA-Verhaltensweisen wie Authentifizierung und das Auslieferungsmodell der Veröffentlichung (Veröffentlichungs-Snapshot, revision, nur Veröffentlichtes ist sichtbar) siehe CDA-Übersicht. Da ein Content Type das Schema einer Vorlage ist, nimmt er bei der Abfrage keinen locale-Parameter entgegen.

Ressourcenstruktur

Im Folgenden sehen Sie die Form, in der die CDA den veröffentlichten Content Type "Produkt" eines Demo-Space in einer einzelnen Abfrage ausliefert. Neben sys (Systemeigenschaften) besitzt er Inhaltseigenschaften wie name, displayField, publishWithAuthor und fields.

{
  "sys": {
    "id": "3trmXRLdJF4GBlAjtcuoZ7Pnxj8dlA",
    "type": "ContentType",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "createdAt": "2026-06-14T17:04:46.846Z",
    "updatedAt": "2026-06-17T03:13:49.943Z",
    "revision": 7
  },
  "name": "Produkt",
  "displayField": "productName",
  "fields": [
    { "id": "5n06s7ocmwdi", "name": "Produktname", "apiName": "productName", "type": "ShortText", "localized": true, "required": true, "validations": [], "disabled": false },
    { "id": "1gecyz8g4llwf", "name": "Preis", "apiName": "price", "type": "Long", "localized": false, "required": false, "validations": [], "disabled": false },
    { "id": "3ow4popgz54zg", "name": "Beschreibung", "apiName": "description", "type": "RichText", "localized": true, "required": false, "validations": [], "disabled": false },
    { "id": "2alxdptmdub1s", "name": "Foto", "apiName": "photo", "type": "Refer", "localized": false, "required": false, "validations": [], "disabled": false, "targetType": "Media" },
    {
      "id": "2a80lehazfx3t",
      "name": "Marke",
      "apiName": "brand",
      "type": "Refer",
      "localized": false,
      "required": false,
      "validations": [
        { "referContentType": [ { "sys": { "id": "3trmXRM3RqbgSnifyg7OveRYWnJWEG", "type": "Refer", "targetType": "ContentType" } } ] }
      ],
      "disabled": false,
      "targetType": "Content"
    }
  ],
  "publishWithAuthor": false
}

Wichtige Schlüssel:

• sys.id: Die eindeutige Kennung des Content Type. Sie wird in den {contentTypeId} des Pfads für die Einzelabfrage eingesetzt.
• sys.revision: Die Version zum Zeitpunkt der Veröffentlichung. Da die CDA das verwaltungsbezogene version nicht enthält, ist revision der einzige Wert, der die veröffentlichte Version angibt.
• name: Der Name des Content Type (z. B. Produkt).
• displayField: Der apiName des Feldes, das in der Content-Studio-Liste jeden Content stellvertretend darstellt (z. B. productName).
• publishWithAuthor: Ob beim Veröffentlichen eines Content die Autoreninformation mitgeführt wird (im Beispiel false).
• fields: Die Liste der Felder, die diese Vorlage definiert. Die Struktur jedes Eintrags wird unten unter Felder erläutert.

Systemeigenschaften (sys)

Das sys eines veröffentlichten Content Type enthält nur Eigenschaften für den Veröffentlichungs-Snapshot. space, createdBy und updatedBy werden in der Refer-Form ({ "sys": { "id", "type": "Refer", "targetType" } }) eingesetzt.

Da es sich um einen Veröffentlichungs-Snapshot handelt, werden version, status, publish und archive, die im sys der CMA vorkommen, nicht mitgeführt. Der einzige Wert, der die veröffentlichte Version angibt, ist revision.

Felder

fields ist die Liste der Felder, die dieser Content Type definiert. Jeder Eintrag hat die folgende Struktur (FieldDefinition).

Feldarten (type)

type bestimmt, wie ein Wert gespeichert und abgefragt wird. Bei einigen Typen unterscheidet sich das Suchverhalten.

Im Beispiel "Produkt" ist Produktname ein ShortText, Preis ein Long, Beschreibung ein RichText, Foto ein Refer (targetType: Media) und Marke ein Refer (targetType: Content). Das Feld Marke beschränkt über referContentType in validations die Referenz auf Content eines bestimmten Content Type (hier "Marke", sys.id gleich 3trmXRM3RqbgSnifyg7OveRYWnJWEG).

Der vollständige Schlüsselkatalog der in validations verwendbaren Validierungsregeln ist in CMA Content Type zusammengestellt. Auch der von der CDA ausgelieferte Veröffentlichungs-Snapshot enthält dieselbe Struktur unverändert.

API

Die Basis-URL der beiden folgenden Endpunkte ist https://cda.weegloo.com/v1, und im Authorization-Header wird ein Bearer-Token zur Authentifizierung an der CDA benötigt. Da ein Content Type eine Vorlage (ein Schema) ist und somit nicht Gegenstand einer Sprachauswahl, nimmt er im Unterschied zur Content-Abfrage keinen locale-Query-Parameter entgegen.

Verwandte Dokumente

• CMA Content Type: Die Verwaltungs-API zum Erstellen und Bearbeiten von Content Types (einschließlich der vollständigen Spezifikation von Feldtypen und Validierungen).
• CDA Content: Veröffentlichten Content empfangen, der dieser Vorlage folgt.
• Status und Veröffentlichung (Konzept): Die Bedeutung von Veröffentlichung und Versionen.