Locale

Locale ist die Spracheinstellung, die eine Space unterstützt. Jede Locale besitzt einen Sprachcode (code, z. B. ko-KR), die Angabe, ob sie die Standard-Locale der Space ist (default), ob sie beim Befüllen von Pflichtfeldern optional ist (optional) und die Locale, in der bei fehlendem Wert ersatzweise gesucht wird (fallbackCode). Die CDA (Content Delivery API) liefert diese Liste schreibgeschützt aus. Das Anlegen oder Ändern einer Locale fällt in den Zuständigkeitsbereich der CMA Locale.

Der Wert des locale-Query-Parameters, den Sie beim Abruf von Content oder Media übergeben, ist genau dieser code der Locale. Um zu erfahren, welche Codes zulässig sind, lesen Sie zuerst über diesen Endpunkt die Liste der von der Space unterstützten Locale und verwenden den darin enthaltenen code.

Ressourcenstruktur

Im Folgenden sehen Sie, in welcher Form die CDA eine Locale ("Korean (South Korea)") der Demo-Space ausliefert. Neben sys (Systemeigenschaften) besitzt sie die Inhaltseigenschaft optional der Locale.

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7OGfZoXmkOU8",
    "type": "Locale",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "name": "Korean (South Korea)",
    "default": false,
    "code": "ko-KR",
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-15T15:14:11.710Z",
    "updatedAt": "2026-06-17T10:43:32.034Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "version": 3
  },
  "optional": false
}

Wichtige Schlüssel:

• sys.code: Der Sprachcode dieser Locale. Diesen Wert setzen Sie in den locale-Parameter beim Abruf von Content und Media ein.
• sys.default: Gibt an, ob diese Locale die Standard-Locale der Space ist. Eine Space hat genau eine Standard-Locale, und nur bei dieser ist default gleich true.
• sys.name: Der menschenlesbare Name (z. B. "Korean (South Korea)"). Im Abrufparameter wird nicht dieser Name, sondern der code verwendet.
• optional: Gibt an, ob diese Locale beim Befüllen von Pflichtfeldern (required) leer bleiben darf. Beide Locale im obigen Beispiel haben optional gleich false.
• fallbackCode: Der code einer anderen Locale, in der bei fehlendem Wert ersatzweise gesucht wird (optional). Erscheint nur dann in der Antwort, wenn er gesetzt ist. Im obigen Beispiel ist er nicht gesetzt, daher ist der Schlüssel nicht sichtbar.

Systemeigenschaften (sys) und Inhalt

space, createdBy und updatedBy werden in der Refer-Form ({ "sys": { "id", "type": "Refer", "targetType" } }) eingebettet.

Da Locale kein Veröffentlichungs-Snapshot, sondern eine Konfigurationsressource der Space ist, sind die im sys von Content enthaltenen revision, status und publish nicht enthalten.

Inhaltseigenschaften:

Verhaltenshinweise

Eine Locale mit default gleich true muss beim Erstellen von Content zwingend befüllt werden; beim Abruf von Content und Media geben Sie locale mit ihrem code an, um die Werte in dieser Sprache zu erhalten. Ist fallbackCode gesetzt, wird bei fehlendem Wert in der angeforderten Locale zur Locale übergegangen, auf die fallbackCode verweist, und dort der Wert gesucht (hat auch diese Locale einen fallbackCode, setzt sich die Kette fort). Eine Locale ohne fallbackCode ergibt bei fehlendem Wert schlicht null. Die Regeln zu Standard-Locale, Fallback und Pflichtbefüllung werden unter Mehrsprachigkeit (Konzept) behandelt.

API

Die Basis-URL der untenstehenden Endpunkte ist https://cda.weegloo.com/v1, und im Authorization-Header wird ein Bearer-Token zur Authentifizierung gegenüber der CDA benötigt. Da die Liste der Locale die Spracheinstellung selbst darstellt, nimmt sie - anders als der Abruf von Content und Media - keinen locale-Query-Parameter entgegen.

Verwandte Dokumente

• CDA-Überblick: Die gesamte CDA und das gemeinsame Auslieferungsverhalten.
• CDA Content: Content abrufen und dabei über locale die zu erhaltende Sprache festlegen.
• Mehrsprachigkeit (Konzept): Regeln zu Standard-Locale, Fallback und Pflichtbefüllung.