ServiceUser

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

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

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

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

{
  "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
}

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

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

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

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

विशेषताप्रकारविवरण
idstringसंसाधन का अद्वितीय पहचानकर्ता।
typestringसंसाधन का प्रकार। ServiceUser के लिए सदैव "ServiceUser"।
spaceRefer<Space>वह Space जिससे यह ServiceUser संबंधित है।
providerstringसाइन अप में उपयोग किया गया OAuth प्रदाता (उदाहरण: google)।
emailstringसाइन अप में उपयोग किया गया ईमेल पता।
createdAtstring (date-time)साइन अप (निर्माण) का समय।
updatedAtstring (date-time)अंतिम संशोधन का समय।

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

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

विशेषताप्रकारविवरण
nicknamestringसदस्य का प्रदर्शन नाम।
avatarUrlstringप्रोफ़ाइल छवि का पता (वैकल्पिक)।
roleOverrideRefer<ServiceUserRole>केवल इस सदस्य को दिया जाने वाला ServiceUserRole (वैकल्पिक)। निर्दिष्ट करने पर यह ServiceLogin की डिफ़ॉल्ट भूमिका पर प्राथमिकता पाता है।
enableLoginbooleanलॉगिन अनुमत है या नहीं। बंद करने पर इस सदस्य का लॉगिन रोक दिया जाता है।

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

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

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

सदस्य को सूची से हटाने का काम कंटेंट स्टूडियो में होता है। तरीक़ा और उसके साथ क्या-क्या हटता है, यह सेवा सदस्यों का प्रबंधन में बताया गया है।

किसी एक सदस्य को अन्य सदस्यों द्वारा बनाए गए संसाधनों तक संभालने देना हो, तो उस अनुमति वाला ServiceUserRole अलग से बनाकर उस सदस्य के roleOverride में निर्दिष्ट करें। कोई सदस्य किस तक पहुँचता है, यह उस सदस्य पर लागू होने वाला ServiceUserRole तय करता है। नियम के createdBy फ़िल्टर को :self पर लगाने पर वह क्रिया केवल अपने बनाए हुए को लक्ष्य बनाती है, और फ़िल्टर न लगाने पर अन्य सदस्यों द्वारा बनाए गए को भी लक्ष्य बनाती है। दोनों भूमिकाएँ अलग-अलग बनाने का तरीका ServiceUserRole में बताया गया है।

API

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

सूची को sys.email से छानते समय केवल ठीक-ठीक मिलान वाले operators का उपयोग किया जाता है (eq·ne·in·nin)। सदस्य का पता एन्क्रिप्ट होकर संग्रहीत होता है, इसलिए उस निरूपण पर केवल यही तय किया जा सकता है कि वह समान है या नहीं, और prefix या क्रम-तुलना बिना कोई त्रुटि दिए 0 परिणाम लौटा देती हैं। पते से सदस्य ढूँढा और परिणाम खाली आया, तो पहले operator की जाँच करें। पते के किसी हिस्से से ढूँढने वाली खोज इस फ़िल्टर से नहीं की जा सकती।