Space
अंतिम अपडेट: 22 जून 2026
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" } },
"plan": { "sys": { "id": "free", "type": "Refer", "targetType": "Plan" } },
"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>.plan: इस Space की सब्सक्रिप्शन प्लान की ओर इंगित करने वालाRefer<Plan>(उदा.:free).
सिस्टम विशेषताएँ (sys) और मुख्य भाग
हर Space अपनी साझा सिस्टम विशेषताएँ sys ऑब्जेक्ट में रखता है. organization एक Refer<Organization> है, plan एक Refer<Plan> है, और createdBy, updatedBy Refer आकार ({ "sys": { "id", "type": "Refer", "targetType" } }) में आते हैं.
| विशेषता | प्रकार | विवरण |
|---|---|---|
id | string | संसाधन का अद्वितीय पहचानकर्ता. |
type | string | संसाधन का प्रकार. Space के लिए हमेशा "Space". |
organization | Refer<Organization> | यह Space जिस ऊपरी Organization के अधीन है. |
plan | Refer<Plan> | सब्सक्रिप्शन प्लान. उदा.: free. |
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 बढ़ता है.
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 की भाषा सेटिंग.
