Organization
अंतिम अपडेट: 22 जून 2026
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> है।
| गुण | प्रकार | विवरण |
|---|---|---|
id | string | संसाधन का अद्वितीय पहचानकर्ता। |
type | string | संसाधन का प्रकार। Organization के लिए हमेशा "Organization"। |
createdBy | Refer<User> | बनाने वाला उपयोगकर्ता। |
createdAt | string (date-time) | बनाए जाने का समय। |
updatedBy | Refer<User> | अंतिम बार संशोधित करने वाला उपयोगकर्ता। |
updatedAt | string (date-time) | अंतिम संशोधन का समय। |
version | integer (≥1) | संसाधन संस्करण। हर संशोधन पर 1 बढ़ता है। |
isOfficial | boolean | आधिकारिक Organization है या नहीं। |
plan | Refer<Plan> | सब्सक्रिप्शन प्लान। उदाहरण: free। |
मुख्य गुण:
| गुण | प्रकार | विवरण |
|---|---|---|
name | string (1~64) | Organization का नाम। बनाते व संशोधित करते समय निर्दिष्ट किया जाता है। |
description | string (1~128) | Organization का विवरण। वैकल्पिक मद। |
icon | string (पढ़ना) / object (लिखना) | Organization आइकन। प्रतिक्रिया में यह एक छवि URL स्ट्रिंग होती है। संशोधन अनुरोध में इसे अपलोड की गई फ़ाइल को इंगित करने वाले ऑब्जेक्ट { "upload": { "sys": { ..., "targetType": "Upload" } } } के रूप में भेजा जाता है (Upload API से प्राप्त Upload संदर्भ)। |
Organization एक सेटिंग संसाधन है जिसमें प्रकाशन की अवधारणा नहीं होती। इसलिए Content व Media के विपरीत sys में publish, archive या status नहीं होते, केवल version होता है। version हर बार Organization के संशोधित होने पर बढ़ता है।
API
नीचे दिए गए सभी एंडपॉइंट का आधार URL https://cma.weegloo.com/v1 है, और Authorization हेडर में CMA को प्रमाणित करने वाला Bearer टोकन आवश्यक है। संशोधन व आंशिक संशोधन के लिए आशावादी समवर्तीता नियंत्रण हेतु X-Weegloo-Version हेडर (वर्तमान संसाधन का sys.version) साथ भेजना आवश्यक है। बनाने और हटाने में यह हेडर नहीं होता।
संबंधित दस्तावेज़
- Space: इस Organization के अंतर्गत आने वाला Space।
- Organization Membership: Organization के सदस्य और मेरी सदस्य संगठनों की सूची।
