Locale

Locale एक Space द्वारा समर्थित भाषा सेटिंग है। हर Locale का एक भाषा कोड (code, उदाहरण: ko-KR, en-US) होता है, और Content या Media के field मान इसी Locale के अनुसार अलग-अलग संग्रहीत होते हैं। हिंदी मान और अंग्रेज़ी मान को एक ही field में साथ-साथ रखा जा सकता है, और पढ़ते समय जिस भाषा का मान चाहिए उसे चुनकर लिया जा सकता है।

यह पृष्ठ Locale को बनाने और बदलने वाले CMA (Content Management API) प्रबंधन कार्यों को कवर करता है। प्रकाशित Locale सूची को आगंतुकों तक केवल-पढ़ने के रूप में पहुँचाने वाला पक्ष CDA Locale है।

संसाधन संरचना

नीचे डेमो Space का एक डिफ़ॉल्ट Locale ("English (United States)") है। sys (सिस्टम गुण) के साथ-साथ, इसमें Locale का बॉडी गुण optional भी होता है।

{
  "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
}

मुख्य keys:

• code: इस Locale का भाषा कोड है (उदाहरण: en-US)। Content, Media के query के locale पैरामीटर में यह मान डालकर उस भाषा का मान प्राप्त किया जाता है। इसे बनाते समय निर्दिष्ट किया जाता है, और उसके बाद बदला नहीं जा सकता।
• default: यह बताता है कि यह Locale Space का डिफ़ॉल्ट Locale है या नहीं। एक Space में एक डिफ़ॉल्ट Locale होता है, और केवल उसी Locale में default true होता है।
• optional: यह बताता है कि आवश्यक (required) field भरते समय इस Locale को खाली छोड़ा जा सकता है या नहीं। ऊपर का उदाहरण false है, इसलिए इसे खाली नहीं छोड़ा जा सकता।
• fallbackCode: जब मान न हो तब उसके बजाय जिस अन्य Locale में खोजा जाए उसका code (वैकल्पिक)। यह केवल तभी प्रतिक्रिया में दिखाई देता है जब इसे सेट किया गया हो। ऊपर के उदाहरण में यह सेट नहीं है, इसलिए key दिखाई नहीं देती।

सिस्टम गुण (sys) और बॉडी

space, createdBy, updatedBy Refer आकार ({ "sys": { "id", "type": "Refer", "targetType" } }) में आते हैं।

बॉडी गुण:

name code से स्वचालित रूप से निकाला जाता है (उदाहरण: ja-JP → "Japanese (Japan)")। इसलिए बनाने, संशोधन की बॉडी में name नहीं डाला जाता।

Locale एक सेटिंग संसाधन है जिसमें प्रकाशन की अवधारणा नहीं है। इसलिए Content, Media के विपरीत इसके sys में publish, archive, status नहीं होते, केवल version होता है। version Locale को संशोधित करने पर हर बार बढ़ता है।

डिफ़ॉल्ट Locale, optional, fallback

ये तीन गुण क्रमशः निम्न को निर्धारित करते हैं।

• default: यह बताता है कि यह Space का डिफ़ॉल्ट Locale है या नहीं। एक Space में डिफ़ॉल्ट केवल एक होता है, और केवल उसी Locale में default true होता है। बनाते समय default निर्दिष्ट नहीं किया जा सकता (नया बनाया गया Locale डिफ़ॉल्ट नहीं होता)। डिफ़ॉल्ट बदलने के लिए संशोधन (PUT) में default को true दें। तब वह Locale नया डिफ़ॉल्ट बन जाता है, और मौजूदा डिफ़ॉल्ट हट जाता है।
• optional: यह बताता है कि आवश्यक (required) field भरते समय इस Locale को खाली छोड़ा जा सकता है या नहीं। यदि optional false हो तो उस भाषा का मान अवश्य भरना होता है, और यदि true हो तो उसे खाली छोड़ा जा सकता है।
• fallbackCode: जब मान न हो तब उसके बजाय जिस अन्य Locale में खोजा जाए उसका code है। यदि अनुरोधित Locale में मान न हो तो fallbackCode द्वारा इंगित Locale पर जाकर मान खोजा जाता है। जिस Locale पर गया उसमें भी fallbackCode हो तो यह आगे जारी रहने वाली चेन बन जाती है। यदि सेट न किया जाए तो key स्वयं प्रतिक्रिया में नहीं होती।

डिफ़ॉल्ट Locale, आवश्यक भराई, fallback का विस्तृत व्यवहार बहुभाषी (अवधारणा) में कवर किया गया है।

API

नीचे दिए गए सभी endpoints का आधार URL https://cma.weegloo.com/v1 है, और Authorization हेडर में CMA को प्रमाणित करने वाला Bearer टोकन आवश्यक है। संशोधन, आंशिक संशोधन के लिए आशावादी समवर्तीयता नियंत्रण हेतु X-Weegloo-Version हेडर (वर्तमान संसाधन का sys.version) साथ में भेजना आवश्यक है। बनाने और हटाने में यह हेडर नहीं होता।

संबंधित दस्तावेज़

• CDA Locale: प्रकाशित Locale सूची को आगंतुकों तक पहुँचाना (पढ़ना)।
• बहुभाषी (अवधारणा): डिफ़ॉल्ट Locale, optional, fallbackCode नियम।
• Content: field मानों को Locale के अनुसार संग्रहीत करने वाला बॉडी डेटा।