ServiceUser

ServiceUser वह प्रोडक्ट end-user है जिसने ServiceLogin के ज़रिए साइन अप किया है, यानी एक सदस्य खाता। यह Weegloo प्लेटफ़ॉर्म खाते (कंटेंट स्टूडियो में लॉग इन करने वाला Weegloo User) से अलग पहचान है, और ServiceUser का टोकन ACMA/ACDA के विरुद्ध प्रमाणित होता है।

ServiceUser तब बनता है जब कोई सदस्य ServiceLogin के ज़रिए स्वयं साइन अप करता है। इसीलिए इस API में create और delete एंडपॉइंट नहीं हैं, केवल पढ़ना और व्यवस्थापक (Weegloo User) द्वारा कुछ संशोधन उपलब्ध हैं।

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

नीचे एक ServiceUser की एकल पढ़ने की प्रतिक्रिया दी गई है। sys (सिस्टम विशेषताएँ) के साथ-साथ, इसमें सदस्य प्रदर्शन जानकारी और अनुमति सेटिंग रखने वाली मुख्य विशेषताएँ nickname, avatarUrl, roleOverride, enableLogin, isAdmin होती हैं।

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7PSusr01Ex",
    "type": "ServiceUser",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "provider": "google",
    "email": "buyer@example.com",
    "createdAt": "2026-06-18T12:50:00.000Z",
    "updatedAt": "2026-06-18T12:50:00.000Z"
  },
  "nickname": "नियमित ग्राहक",
  "avatarUrl": "https://lh3.example.com/a/buyer-avatar",
  "roleOverride": null,
  "enableLogin": true,
  "isAdmin": false
}

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

• sys.email: वह ईमेल पता जो सदस्य ने साइन अप में उपयोग किया। sys.provider के साथ मिलकर यह दिखाता है कि किस खाते से साइन अप किया गया।
• sys.provider: साइन अप में उपयोग किया गया OAuth प्रदाता (उदाहरण: google)।
• roleOverride: वह Refer जो तब डाला जाता है जब इस सदस्य को ही एक अलग ServiceUserRole देना हो। यदि खाली (null) हो, तो यह ServiceLogin की डिफ़ॉल्ट भूमिका का पालन करता है।
• isAdmin: चालू करने पर यह सदस्य अन्य सदस्यों द्वारा बनाए गए संसाधनों को हटा सकता है। यह एक सीमित अनुमति है, और यह अन्य सदस्यों के संसाधनों पर संशोधन, पढ़ने की अनुमति नहीं देती।

सिस्टम विशेषताएँ (sys)

हर ServiceUser अपनी साझा सिस्टम विशेषताएँ sys ऑब्जेक्ट में रखता है। space Refer रूप ({ "sys": { "id", "type": "Refer", "targetType" } }) में आता है।

ServiceUser वह संसाधन है जिसे सदस्य अपने स्वयं के साइन अप से बनाता है, इसलिए अन्य CMA संसाधनों के विपरीत इसके sys में createdBy, updatedBy, version नहीं होते। चूँकि version नहीं है, इसलिए संशोधन (PUT, PATCH) में भी X-Weegloo-Version हेडर नहीं भेजा जाता। प्रकाशन की अवधारणा भी नहीं है, इसलिए publish, archive, status भी नहीं हैं।

मुख्य विशेषताएँ

सदस्य प्रबंधन

ServiceUser साइन अप से बनता है, इसलिए न तो इसका create एंडपॉइंट है और न ही delete एंडपॉइंट। व्यवस्थापक (Weegloo User) संशोधन (PUT, PATCH) के ज़रिए निम्न तीन चीज़ें समायोजित कर सकता है।

• roleOverride निर्दिष्ट/हटाना: केवल किसी विशेष सदस्य को एक अलग ServiceUserRole देता है। सशुल्क श्रेणी, मॉडरेटर, बीटा समूह जैसे मामलों में जब केवल एक सदस्य के साथ अलग व्यवहार करना हो, तब इसका उपयोग होता है। निर्दिष्ट किया गया roleOverride ServiceLogin के defaultRole पर प्राथमिकता पाता है।
• enableLogin टॉगल: बंद करने पर उस सदस्य का लॉगिन रोक दिया जाता है।
• isAdmin टॉगल: चालू करने पर मॉडरेशन के लिए अन्य सदस्यों द्वारा बनाए गए संसाधनों को हटाया जा सकता है।

isAdmin एक सीमित फ़्लैग है जो केवल अन्य सदस्यों के संसाधनों पर delete जोड़ता है। यह अन्य सदस्यों के संसाधनों पर संशोधन, पढ़ने की अनुमति नहीं देता, और न ही इस सदस्य को Weegloo कंटेंट स्टूडियो व्यवस्थापक (CMA व्यवस्थापक) के रूप में पदोन्नत करता है। साथ ही यह उन कार्यों तक भी पहुँच नहीं खोलता जिन्हें सदस्य का ServiceUserRole मूल रूप से अनुमति नहीं देता।

API

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

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

• ServiceUserRole: roleOverride में दी जाने वाली अनुमतियों का समूह।
• ServiceLogin: सदस्य साइन अप, डिफ़ॉल्ट भूमिका (defaultRole) सेटिंग।
• ACMA/ACDA अवलोकन: वह API जिसे ServiceUser कॉल करता है।