Locale

Locale किसी Space द्वारा समर्थित भाषा सेटिंग है। हर Locale में एक भाषा कोड (code, उदाहरण: ko-KR), यह Space का डिफ़ॉल्ट Locale है या नहीं (default), आवश्यक फ़ील्ड भरते समय यह वैकल्पिक है या नहीं (optional), और मान न होने पर जिस Locale में देखा जाए (fallbackCode) होता है। CDA (Content Delivery API) इस सूची को केवल-पढ़ने (read-only) के रूप में डिलीवर करता है। Locale बनाने या बदलने का काम CMA Locale के अधिकार में है।

Content या Media को क्वेरी करते समय जो locale क्वेरी पैरामीटर मान भेजा जाता है, वही इस Locale का code होता है। कौन-सा कोड डाला जा सकता है यह जानने के लिए पहले इस एंडपॉइंट से Space द्वारा समर्थित Locale सूची पढ़ें, और उसमें मौजूद code का उपयोग करें।

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

नीचे डेमो Space के एक Locale ("Korean (South Korea)") को CDA जिस रूप में डिलीवर करता है वह दिखाया गया है। sys (सिस्टम विशेषताएँ) के साथ-साथ, इसमें Locale की मुख्य विशेषता optional होती है।

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

मुख्य कुंजियाँ:

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

सिस्टम विशेषताएँ (sys) और मुख्य भाग

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

Locale कोई प्रकाशन स्नैपशॉट नहीं बल्कि Space का सेटिंग संसाधन है, इसलिए Content के sys में मौजूद revision, status, publish इसमें शामिल नहीं होते।

मुख्य विशेषताएँ:

व्यवहार संबंधी नोट

default का मान true वाला Locale Content बनाते समय अनिवार्य रूप से भरना होता है, और Content, Media क्वेरी में locale को उसी code से निर्दिष्ट करके उस भाषा का मान प्राप्त किया जाता है। यदि fallbackCode सेट है, तो अनुरोधित Locale में मान न होने पर fallbackCode जिस Locale की ओर इशारा करता है उस पर जाकर मान खोजा जाता है (यदि उस Locale में भी fallbackCode है तो चेन आगे बढ़ती रहती है)। fallbackCode रहित Locale में मान न होने पर वह सीधे null हो जाता है। डिफ़ॉल्ट Locale, fallback, अनिवार्य भरने के नियमों को बहुभाषा (अवधारणा) में समझाया गया है।

API

नीचे दिए गए एंडपॉइंट का बेस URL https://cda.weegloo.com/v1 है, और Authorization हेडर में CDA को प्रमाणित करने वाला Bearer टोकन आवश्यक है। Locale सूची स्वयं भाषा सेटिंग है, इसलिए Content, Media क्वेरी के विपरीत यह locale क्वेरी पैरामीटर स्वीकार नहीं करती।

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

• CDA अवलोकन: संपूर्ण CDA और सामान्य डिलीवरी व्यवहार।
• CDA Content: locale से प्राप्त की जाने वाली भाषा तय करके Content डिलीवर करवाना।
• बहुभाषा (अवधारणा): डिफ़ॉल्ट Locale, fallback, अनिवार्य भरने के नियम।