Organization

Organization एक शीर्ष-स्तरीय कंटेनर है जो Space को रखता है। एक कंपनी या टीम इकाई एक Organization के अनुरूप होती है, और उसके नीचे कई Space रखे जाते हैं। सब्सक्रिप्शन प्लान (plan) और सदस्यता Organization स्तर पर प्रबंधित होती है, इसलिए बिलिंग और सदस्य अनुमतियाँ Space के बजाय इस Organization के आधार पर लागू होती हैं।

आप जिन Organization के सदस्य हैं उनकी सूची GET /me/organization-memberships से प्राप्त की जाती है। इस संसाधन में पूरी सूची लौटाने वाला कोई एंडपॉइंट नहीं है।

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

नीचे Organization "DailyWear कंपनी" की एकल पुनर्प्राप्ति प्रतिक्रिया है। इसमें sys (सिस्टम गुण) और मुख्य गुण name व description होते हैं।

{
  "sys": {
    "id": "ilLRJxDp",
    "type": "Organization",
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-05-11T10:51:16.832Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-05-11T10:51:16.832Z",
    "version": 1,
    "isOfficial": false,
    "plan": { "sys": { "id": "free", "type": "Refer", "targetType": "Plan" } }
  },
  "name": "DailyWear कंपनी",
  "description": "ऑनलाइन कपड़ा और एक्सेसरीज़ स्टोर चलाने वाली कंपनी"
}

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

• name: Organization का नाम (1~64 अक्षर)। कंपनी या टीम का प्रदर्शन नाम।
• description: Organization का विवरण (1~128 अक्षर, वैकल्पिक)।
• plan: इस Organization की सब्सक्रिप्शन प्लान को इंगित करने वाला Refer<Plan> (उदाहरण: free)। बिलिंग प्लान यहाँ से जुड़ी होती है।
• isOfficial: यह आधिकारिक Organization है या नहीं (boolean)।

सिस्टम गुण (sys) और मुख्य गुण

हर Organization अपने सामान्य सिस्टम गुण sys ऑब्जेक्ट में रखता है। createdBy व updatedBy Refer आकार ({ "sys": { "id", "type": "Refer", "targetType" } }) में आते हैं, और plan एक Refer<Plan> है।

मुख्य गुण:

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

संशोधन (PUT) पूरे संसाधन को बदल देता है, और मान न भेजे जाने का अर्थ इन दो वैकल्पिक मदों में एक-दूसरे से उलटा है। icon को छोड़ देने पर पहले से सहेजा गया आइकन वैसा ही बना रहता है, जबकि consoleHomeUrl को छोड़ देने पर सहेजा गया पता मिट जाता है। पहले से निर्दिष्ट पते को बनाए रखने के लिए हर संशोधन में उस मान को साथ भेजना पड़ता है। आंशिक संशोधन (PATCH) केवल उन्हीं गुणों को छूता है जो पैच में लिखे गए हैं, इसलिए consoleHomeUrl निर्दिष्ट न करने पर वह वैसा ही रहता है।

होम स्क्रीन पर दिखाए जाने वाले पेज की शर्तें

पता सहेज लिए जाने का यह अर्थ नहीं है कि वह पेज दिख ही जाएगा। दिखाए जाने से इनकार करने वाला पता निर्दिष्ट करने पर भी सहेजने का अनुरोध सफल होता है और कोई त्रुटि नहीं लौटती; यह केवल इस रूप में सामने आता है कि होम स्क्रीन पर कुछ भी नहीं दिखता।

उस जगह दिखाई देने के लिए पेज की ओर से नीचे दी गई बातें पूरी होनी चाहिए।

• HTTPS पर परोसें। कंसोल HTTPS पर चलता है, इसलिए सुरक्षित कनेक्शन पर न होने वाले पेज को ब्राउज़र दिखाने से रोक देता है।
• दूसरे पेज के भीतर दिखाए जाने की अनुमति दें। प्रतिक्रिया हेडर में Content-Security-Policy: frame-ancestors https://console.weegloo.com निर्दिष्ट करें। यदि X-Frame-Options से दिखाया जाना रोका जा रहा है, तो उसे भी साथ में समायोजित करें।
• कुकी का उपयोग करते हैं तो उन्हें SameSite=None; Secure के साथ जारी करें। यह दूसरी साइट के भीतर दिखाए जाने का संदर्भ है, इसलिए यह चिह्न न होने पर कुकी भेजी नहीं जाती।

पेज <iframe> के भीतर दिखाया जाता है, और उस फ़्रेम पर केवल नीचे दी गई अनुमतियाँ खुली रहती हैं।

यहाँ जो नहीं है, वह काम नहीं करता। ऐसी स्थिति में कोई त्रुटि नहीं होती और कॉल चुपचाप अनदेखा कर दिया जाता है, इसलिए कोड से यह पता नहीं चलता कि वह रोका गया या नहीं।

फ़्रेम पर referrerpolicy="strict-origin-when-cross-origin" भी साथ निर्दिष्ट रहता है। इसलिए पेज तक कंसोल के मूल (origin) तक की ही जानकारी पहुँचती है, यह नहीं पहुँचता कि वह किस स्क्रीन से खोला गया था।

sandbox से अलग, जिन पेजों के लिए लॉगिन आवश्यक है वे ठीक से काम नहीं भी कर सकते। अधिकांश लॉगिन प्रदाता दूसरे पेज के भीतर लॉगिन को रोकते हैं, इसलिए सोशल लॉगिन प्रायः काम नहीं करता।

त्रुटियाँ

ये कोड Organization के साथ काम करते समय मिलते हैं। सभी संसाधनों में समान रूप से मिलने वाले कोड के लिए सामान्य त्रुटियाँ देखें।

API

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

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

• Space: इस Organization के अंतर्गत आने वाला Space।
• Organization Membership: Organization के सदस्य और मेरी सदस्य संगठनों की सूची।