Space Membership

Space Membership एक रिकॉर्ड है जो दर्शाता है कि कोई उपयोगकर्ता किसी Space में किन SpaceRole के साथ शामिल है। एक उपयोगकर्ता कई Space में शामिल हो सकता है, और हर Space में उसकी अनुमतियाँ भिन्न हो सकती हैं, इसलिए उपयोगकर्ता, Space और अनुमति का हर एक संयोजन एक Space Membership से मेल खाता है। Organization Membership ईमेल से आमंत्रित करके किसी नए व्यक्ति को जोड़ती है, जबकि इसके विपरीत Space Membership पहले से मौजूद उपयोगकर्ता को user संदर्भ से जोड़ती है और roles(SpaceRole संदर्भों की सरणी) से अनुमतियाँ देती है। यह ईमेल आमंत्रण नहीं है।

आप जिन Space में शामिल हैं उनकी सूची GET /me/space-memberships से प्राप्त करते हैं। यदि आप साथ में include=1 भेजते हैं, तो जिस Space की ओर संकेत किया गया है उसका विवरण भी प्रतिक्रिया में शामिल होता है।

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

नीचे एक Space Membership की एकल पुनर्प्राप्ति प्रतिक्रिया दी गई है। sys(सिस्टम विशेषताएँ) में वह उपयोगकर्ता (user) और Space(space) होते हैं जिनकी ओर यह मेम्बरशिप संकेत करती है, और मुख्य विशेषता के रूप में अनुमति समूह (roles) होता है।

{
  "sys": {
    "id": "3trmXRLdJF4GBlAjtcuoWfVunfJ8uV",
    "type": "SpaceMembership",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "user": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "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:04.737Z",
    "version": 1
  },
  "roles": [
    { "sys": { "id": "3trmXRLdJF4GBlAjtcuoWfVubsasp4", "type": "Refer", "targetType": "SpaceRole" } }
  ]
}

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

• space: उस Space की ओर संकेत करने वाला Refer<Space> जिसमें यह मेम्बरशिप शामिल है।
• user: इस मेम्बरशिप के उपयोगकर्ता की ओर संकेत करने वाला Refer<User>। सदस्य के रूप में जोड़ा गया उपयोगकर्ता यहाँ बँधता है।
• roles: इस उपयोगकर्ता के पास Space में मौजूद अनुमतियों का समूह। SpaceRole की ओर संकेत करने वाला Refer<SpaceRole> सरणी, जिसमें एक सदस्य एक साथ कई SpaceRole रख सकता है।

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

हर Space Membership सामान्य सिस्टम विशेषताओं को sys ऑब्जेक्ट में रखती है। space, user, createdBy, updatedBy Refer रूप ({ "sys": { "id", "type": "Refer", "targetType" } }) में आते हैं।

मुख्य भाग की विशेषताएँ:

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

API

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

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

• SpaceRole: roles में डाली जाने वाली SpaceRole(अनुमति समूह) की परिभाषा।
• Space: वह Space जिसमें यह मेम्बरशिप शामिल है।
• Organization Membership: Organization स्तर के सदस्य और भूमिकाएँ।