Locale

Locale es la configuración de idiomas que admite un Space. Cada Locale tiene un código de idioma (code, por ejemplo: ko-KR, en-US) y los valores de campo de Content o Media se almacenan por separado para cada Locale. El valor en coreano y el valor en inglés se guardan juntos en el mismo campo, y al consultar se selecciona el valor del idioma deseado.

Esta página trata las operaciones de gestión de la CMA (Content Management API) para crear y modificar Locale. La parte que entrega la lista de Locale publicados a los visitantes en modo de solo lectura es CDA Locale.

Estructura del recurso

A continuación se muestra un Locale por defecto del Space de demostración ("English (United States)"). Junto con sys (propiedades del sistema), tiene optional, la propiedad de cuerpo del 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
}

Claves principales:

• code: el código de idioma de este Locale (por ejemplo: en-US). Se pone este valor en el parámetro locale de las consultas de Content y Media para recibir el valor de ese idioma. Se especifica al crear y después no se puede cambiar.
• default: indica si este Locale es el Locale por defecto del Space. Un Space tiene un Locale por defecto, y solo en ese Locale default es true.
• optional: indica si este Locale se puede dejar vacío al rellenar un campo obligatorio (required). En el ejemplo anterior es false, por lo que no se puede dejar vacío.
• fallbackCode: el code de otro Locale en el que buscar como alternativa cuando no hay valor (opcional). Solo aparece en la respuesta cuando está configurado. En el ejemplo anterior no está configurado, por lo que la clave no se muestra.

Propiedades del sistema (sys) y cuerpo

space, createdBy y updatedBy se incluyen con forma Refer ({ "sys": { "id", "type": "Refer", "targetType" } }).

Propiedades del cuerpo:

name se calcula automáticamente a partir de code (por ejemplo: ja-JP → "Japanese (Japan)"). Por eso no se incluye name en el cuerpo de creación ni de modificación.

Locale es un recurso de configuración que no tiene concepto de publicación. Por eso, a diferencia de Content y Media, en sys no tiene publish, archive ni status, y solo tiene version. version aumenta cada vez que se modifica el Locale.

Locale por defecto, optional y fallback

Las tres propiedades determinan lo siguiente.

• default: indica si es el Locale por defecto del Space. En un Space solo hay uno por defecto, y solo en ese Locale default es true. Al crear no se puede especificar default (un Locale recién creado no es el por defecto). Para cambiar el por defecto, se pone default a true en la modificación (PUT). Entonces ese Locale pasa a ser el nuevo por defecto y el por defecto anterior se desactiva.
• optional: indica si este Locale se puede dejar vacío al rellenar un campo obligatorio (required). Si optional es false, hay que rellenar obligatoriamente el valor de ese idioma; si es true, se puede dejar vacío.
• fallbackCode: el code de otro Locale en el que buscar como alternativa cuando no hay valor. Si el Locale solicitado no tiene valor, se pasa al Locale al que apunta fallbackCode para buscar el valor. Si el Locale al que se pasó también tiene fallbackCode, se forma una cadena que continúa. Si no se configura, la clave no aparece en la respuesta.

El comportamiento detallado del Locale por defecto, del rellenado obligatorio y del fallback se trata en Multiidioma (concepto).

API

La URL base de todos los endpoints siguientes es https://cma.weegloo.com/v1, y se necesita un token Bearer que autentique en la CMA en la cabecera Authorization. Para la modificación y la modificación parcial hay que enviar también la cabecera X-Weegloo-Version (el sys.version actual del recurso) para el control de concurrencia optimista. La creación y la eliminación no llevan esta cabecera.

Documentos relacionados

• CDA Locale: entrega la lista de Locale publicados a los visitantes (lectura).
• Multiidioma (concepto): reglas del Locale por defecto, optional y fallbackCode.
• Content: datos de cuerpo que almacenan los valores de campo por Locale.