Space
Space एक कार्यक्षेत्र है जिसमें किसी एक प्रोजेक्ट का सारा कॉन्टेंट रखा जाता है। कॉन्टेंट की संरचना परिभाषित करने वाला Content Type, असल डेटा यानी Content, इमेज और फ़ाइल जैसी Media, और भाषा सेटिंग यानी Locale, ये सब एक ही Space के भीतर रहते हैं। एक Space अपने ऊपरी पात्र Organization के अधीन होता है, और आमतौर पर हर सेवा के लिए एक Space रखा जाता है।
आप जिन Space के सदस्य हैं उनकी सूची GET /me/space-memberships से प्राप्त होती है।
संसाधन संरचना
नीचे Space "DailyWear स्टोर" की एकल पुनर्प्राप्ति प्रतिक्रिया दी गई है। इसमें sys (सिस्टम विशेषताएँ) और मुख्य विशेषता name होती है।
{
"sys": {
"id": "HnQ32YiH",
"type": "Space",
"organization": { "sys": { "id": "ilLRJxDp", "type": "Refer", "targetType": "Organization" } },
"createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
"createdAt": "2026-06-14T14:56:04.737Z",
"updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
"updatedAt": "2026-06-14T14:56:58.670Z",
"version": 2
},
"name": "DailyWear स्टोर"
}मुख्य कुंजियाँ:
name: Space का नाम (1~64 अक्षर)। प्रोजेक्ट या सेवा का प्रदर्शन नाम।organization: यह Space जिस ऊपरी Organization के अधीन है उसकी ओर इंगित करने वालाRefer<Organization>।
सब्सक्रिप्शन प्लान Space से नहीं, बल्कि ऊपरी Organization से जुड़ा होता है। प्लान देखने या बदलने के लिए Organization देखें।
सिस्टम विशेषताएँ (sys) और मुख्य भाग
हर Space अपनी साझा सिस्टम विशेषताएँ sys ऑब्जेक्ट में रखता है। organization एक Refer<Organization> है, और createdBy, updatedBy Refer आकार ({ "sys": { "id", "type": "Refer", "targetType" } }) में आते हैं।
| विशेषता | प्रकार | विवरण |
|---|---|---|
id | string | संसाधन का अद्वितीय पहचानकर्ता। |
type | string | संसाधन का प्रकार। Space के लिए हमेशा "Space"। |
organization | Refer<Organization> | यह Space जिस ऊपरी Organization के अधीन है। |
createdBy | Refer<User> | बनाने वाला उपयोगकर्ता। |
createdAt | string (date-time) | बनाने का समय। |
updatedBy | Refer<User> | अंतिम बार संशोधित करने वाला उपयोगकर्ता। |
updatedAt | string (date-time) | अंतिम संशोधन का समय। |
version | integer (≥1) | संसाधन संस्करण। हर संशोधन पर 1 बढ़ता है। |
मुख्य विशेषताएँ:
| विशेषता | प्रकार | विवरण |
|---|---|---|
name | string (1~64) | Space का नाम। बनाते और संशोधित करते समय निर्दिष्ट किया जाता है। |
description | string (1~128) | Space का विवरण। वैकल्पिक है। |
icon | string (पढ़ना) / object (लिखना) | Space का आइकन। प्रतिक्रिया में यह एक इमेज URL स्ट्रिंग होती है। संशोधन अनुरोध में इसे अपलोड की गई फ़ाइल की ओर इंगित करने वाले ऑब्जेक्ट { "upload": { "sys": { ..., "targetType": "Upload" } } } के रूप में भेजा जाता है (Upload API से प्राप्त Upload का संदर्भ)। |
Space एक सेटिंग संसाधन है जिसमें प्रकाशन की कोई अवधारणा नहीं है। इसलिए Content और Media के विपरीत, इसके sys में publish, archive, status नहीं होते, केवल version होता है। Space को संशोधित करने पर हर बार version बढ़ता है।
Space की होम स्क्रीन को किसी दूसरे पृष्ठ से बदलने की सेटिंग इस संसाधन में नहीं, बल्कि ऊपरी Organization में है। Organization का consoleHomeUrl निर्दिष्ट करने पर उसके अधीन सभी Space की होम स्क्रीन उसी पृष्ठ में बदल जाती है।
त्रुटियाँ
ये कोड Space के साथ काम करते समय मिलते हैं। सभी संसाधनों में समान रूप से मिलने वाले कोड के लिए सामान्य त्रुटियाँ देखें।
| कोड | शर्त |
|---|---|
WGL422024 | Space के भीतर Content Type, Content, Media, Web Hosting में से एक भी बचा हुआ है, और उसी स्थिति में Space को हटाने का प्रयास किया गया। बचा हुआ सब कुछ हटा देने के बाद ही उसे हटाया जा सकता है। |
WGL422046 | icon के रूप में अपलोड की गई फ़ाइल अनुमत आकार से बड़ी है। |
WGL422047 | icon के रूप में अपलोड की गई फ़ाइल PNG, JPG या WebP नहीं है। |
API
नीचे दिए सभी एंडपॉइंट का आधार URL https://cma.weegloo.com/v1 है, और Authorization हेडर में CMA को प्रमाणित करने वाला Bearer टोकन आवश्यक है। संशोधन और आंशिक संशोधन के लिए आशावादी समवर्तीता नियंत्रण के लिए X-Weegloo-Version हेडर (वर्तमान संसाधन का sys.version) भी भेजना आवश्यक है। बनाने और हटाने में यह हेडर नहीं होता। सूची, निर्माण, संशोधन, आंशिक संशोधन और विलोपन ऊपरी Organization पथ (/organizations/{organizationId}/spaces) के अधीन हैं। एकल पुनर्प्राप्ति नीचे की तरह सीधे /spaces/{spaceId} पथ से की जा सकती है (ऊपरी Organization पथ /organizations/{organizationId}/spaces/{spaceId} पर भी एकल पुनर्प्राप्ति उपलब्ध है)।
संबंधित दस्तावेज़
- Organization: यह Space जिस ऊपरी Organization के अधीन है।
- Space Membership: Space के सदस्य और मेरी सदस्यता वाले Space की पुनर्प्राप्ति।
- Locale: Space की भाषा सेटिंग।