Locale

La Locale est le paramètre de langue pris en charge par un Space. Chaque Locale possède un code de langue (code, par exemple ko-KR, en-US), et les valeurs de champ d'un Content ou d'un Media sont stockées séparément par Locale. La valeur en coréen et la valeur en anglais cohabitent dans le même champ, et lors de la consultation vous récupérez la valeur de la langue souhaitée.

Cette page traite des opérations de gestion CMA (Content Management API) pour créer et modifier une Locale. La transmission en lecture seule de la liste des Locale publiées vers les visiteurs relève de CDA Locale.

Structure de la ressource

Voici l'une des Locale par défaut du Space de démonstration (« English (United States) »). Avec sys (propriétés système), elle possède la propriété de corps optional de la 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
}

Clés principales :

• code : le code de langue de cette Locale (par exemple en-US). Vous placez cette valeur dans le paramètre locale lors de la consultation d'un Content ou d'un Media pour recevoir la valeur dans cette langue. Il se définit à la création et ne peut plus être modifié ensuite.
• default : indique si cette Locale est la Locale par défaut du Space. Un Space a une seule Locale par défaut, et default vaut true uniquement pour cette Locale.
• optional : indique si cette Locale peut rester vide lors du remplissage d'un champ obligatoire (required). Dans l'exemple ci-dessus, la valeur est false, donc elle ne peut pas rester vide.
• fallbackCode : le code d'une autre Locale à consulter à la place lorsqu'aucune valeur n'existe (facultatif). Il n'apparaît dans la réponse que lorsqu'il est défini. Dans l'exemple ci-dessus il n'est pas défini, donc la clé n'apparaît pas.

Propriétés système (sys) et corps

space, createdBy et updatedBy se présentent sous la forme Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Propriétés de corps :

name est calculé automatiquement à partir de code (par exemple ja-JP → "Japanese (Japan)"). Vous n'incluez donc pas name dans le corps de création ni de modification.

La Locale est une ressource de configuration sans notion de publication. C'est pourquoi, contrairement au Content et au Media, son sys ne comporte pas publish, archive ni status, et ne possède que version. La version augmente à chaque modification de la Locale.

Locale par défaut, optional et fallback

Les trois propriétés définissent respectivement ce qui suit.

• default : indique s'il s'agit de la Locale par défaut du Space. Un Space n'a qu'une seule Locale par défaut, et default vaut true uniquement pour cette Locale. Vous ne pouvez pas définir default lors de la création (une Locale nouvellement créée n'est pas la Locale par défaut). Pour changer la Locale par défaut, donnez la valeur true à default lors de la modification (PUT). Cette Locale devient alors la nouvelle Locale par défaut, et l'ancienne est désactivée.
• optional : indique si cette Locale peut rester vide lors du remplissage d'un champ obligatoire (required). Si optional vaut false, la valeur dans cette langue doit obligatoirement être remplie ; si elle vaut true, elle peut rester vide.
• fallbackCode : le code d'une autre Locale à consulter à la place lorsqu'aucune valeur n'existe. Si la Locale demandée n'a pas de valeur, le système passe à la Locale désignée par fallbackCode pour y chercher la valeur. Si cette Locale possède elle aussi un fallbackCode, cela forme une chaîne qui se poursuit. S'il n'est pas défini, la clé elle-même est absente de la réponse.

Le comportement détaillé de la Locale par défaut, du remplissage obligatoire et du fallback est traité dans Multilingue (concept).

API

L'URL de base de tous les points de terminaison ci-dessous est https://cma.weegloo.com/v1, et un jeton Bearer authentifiant CMA est requis dans l'en-tête Authorization. Pour la modification et la modification partielle, vous devez aussi envoyer l'en-tête X-Weegloo-Version (la sys.version actuelle de la ressource) afin d'assurer le contrôle de concurrence optimiste. La création et la suppression n'utilisent pas cet en-tête.

Documents associés

• CDA Locale : transmet (en lecture) la liste des Locale publiées vers les visiteurs.
• Multilingue (concept) : règles de la Locale par défaut, de optional et de fallbackCode.
• Content : les données de corps qui stockent les valeurs de champ par Locale.