Locale

Locale ist die Sprachkonfiguration, die ein Space unterstützt. Jedes Locale hat einen Sprachcode (code, z. B. ko-KR, en-US), und die Feldwerte von Content oder Media werden pro Locale getrennt gespeichert. Koreanische und englische Werte liegen so nebeneinander im selben Feld, und beim Abruf wählen Sie den Wert in der gewünschten Sprache aus.

Diese Seite behandelt die Verwaltungsoperationen der CMA (Content Management API) zum Erstellen und Ändern von Locale. Für die schreibgeschützte Auslieferung der veröffentlichten Locale-Liste an Besucher ist CDA Locale zuständig.

Ressourcenstruktur

Im Folgenden sehen Sie das Standard-Locale eines Demo-Space ("English (United States)"). Neben sys (Systemattribute) enthält es optional als inhaltliches Attribut des Locale.

{
  "sys": {
    "id": "4PXRRUpIqJ1sdcqujzO7lYJD1sReNG",
    "type": "Locale",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "name": "English (United States)",
    "default": true,
    "code": "en-US",
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-17T10:43:31.960Z",
    "updatedAt": "2026-06-17T10:43:31.960Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "version": 1
  },
  "optional": false
}

Wichtigste Schlüssel:

• code: der Sprachcode dieses Locale (z. B. en-US). Diesen Wert übergeben Sie im Parameter locale beim Abruf von Content oder Media, um die Werte in dieser Sprache zu erhalten. Er wird bei der Erstellung festgelegt und kann danach nicht mehr geändert werden.
• default: ob dieses Locale das Standard-Locale des Space ist. Ein Space hat genau ein Standard-Locale, und nur bei diesem ist default gleich true.
• optional: ob dieses Locale beim Befüllen eines erforderlichen (required) Felds leer gelassen werden darf. Das Beispiel oben ist false, darf also nicht leer bleiben.
• fallbackCode: der code eines anderen Locale, in dem ersatzweise nachgeschlagen wird, wenn kein Wert vorhanden ist (optional). Erscheint nur in der Antwort, wenn er gesetzt ist. Im Beispiel oben ist er nicht gesetzt, daher ist der Schlüssel nicht sichtbar.

Systemattribute (sys) und Inhalt

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

Inhaltliche Attribute:

name wird automatisch aus code abgeleitet (z. B. ja-JP → "Japanese (Japan)"). Deshalb wird name im Erstellungs- und Änderungs-Body nicht mitgeschickt.

Locale ist eine Konfigurationsressource ohne Veröffentlichungskonzept. Anders als Content und Media hat sys daher kein publish, archive oder status, sondern nur version. version erhöht sich bei jeder Änderung des Locale.

Standard-Locale, optional und Fallback

Die drei Attribute legen jeweils Folgendes fest.

• default: ob es das Standard-Locale des Space ist. Pro Space gibt es nur ein Standard-Locale, und nur bei diesem ist default gleich true. Beim Erstellen kann default nicht festgelegt werden (ein neu erstelltes Locale ist nicht das Standard-Locale). Um das Standard-Locale zu ändern, setzen Sie default bei der Änderung (PUT) auf true. Dieses Locale wird dann zum neuen Standard, und das bisherige Standard-Locale verliert diesen Status.
• optional: ob dieses Locale beim Befüllen eines erforderlichen (required) Felds leer gelassen werden darf. Ist optional gleich false, muss der Wert in dieser Sprache befüllt werden; bei true darf er leer bleiben.
• fallbackCode: der code eines anderen Locale, in dem ersatzweise nachgeschlagen wird, wenn kein Wert vorhanden ist. Hat das angeforderte Locale keinen Wert, wird zu dem von fallbackCode referenzierten Locale gewechselt, um den Wert zu finden. Hat auch dieses Locale einen fallbackCode, entsteht eine fortlaufende Kette. Wird er nicht gesetzt, fehlt der Schlüssel selbst in der Antwort.

Das genaue Verhalten von Standard-Locale, Pflichtbefüllung und Fallback wird unter Mehrsprachigkeit (Konzept) behandelt.

API

Die Basis-URL aller folgenden Endpunkte ist https://cma.weegloo.com/v1, und im Header Authorization ist ein Bearer-Token zur Authentifizierung gegenüber der CMA erforderlich. Bei Änderung und Teiländerung muss zur optimistischen Nebenläufigkeitskontrolle der Header X-Weegloo-Version (die aktuelle sys.version der Ressource) mitgeschickt werden. Bei Erstellung und Löschung entfällt dieser Header.

Verwandte Dokumente

• CDA Locale: Auslieferung der veröffentlichten Locale-Liste an Besucher (Lesen).
• Mehrsprachigkeit (Konzept): Regeln zu Standard-Locale, optional und fallbackCode.
• Content: die Inhaltsdaten, die Feldwerte pro Locale speichern.