CMA (Content Management API)

अंतिम अपडेट: 3 जुलाई 2026

CMA (Content Management API) एक प्रबंधन API है जो Space के कंटेंट और सेटिंग्स को बनाने, पढ़ने, संपादित करने और हटाने का काम करता है। कंटेंट स्टूडियो में किए जाने वाले काम (कंटेंट लिखना, प्रकाशित करना, सदस्य व भूमिकाओं का प्रबंधन, टोकन जारी करना आदि) को कोड से वैसे ही किया जा सकता है। प्रकाशित कंटेंट को विज़िटर तक पहुँचाने वाला केवल-पढ़ने वाला API अलग से CDA संभालता है।

बेस URL https://cma.weegloo.com/v1 है। कॉल करने वाली पहचान Weegloo User (Weegloo प्लेटफ़ॉर्म खाता) होती है। सर्वर, CI और स्क्रिप्ट में Personal Access Token को, और ब्राउज़र प्रबंधन UI में कंटेंट स्टूडियो लॉगिन प्रवाह द्वारा जारी टोकन को Bearer के रूप में भेजा जाता है। उत्पाद में शामिल हुए सदस्य (ServiceUser) की पहचान से चलने वाले ACMA के साथ टोकन संगत नहीं होते।

सामान्य व्यवहार

नीचे दी गई बातें समग्र रूप से CMA संसाधनों पर लागू होती हैं। हर संसाधन पृष्ठ इन व्यवहारों को आधार मानकर केवल अपनी विशिष्ट सामग्री को कवर करता है।

  • पूर्ण CRUD. बनाना (POST), चयन (GET), संपादन (PUT/PATCH) और हटाना (DELETE) सभी समर्थित हैं। केवल-पढ़ने वाले CDA के विपरीत, लिखना और प्रकाशित करना यहीं होता है।
  • संपादन के लिए वर्शन हेडर आवश्यक है. किसी संसाधन को संपादित करते समय x-weegloo-version हेडर में उस संसाधन का वर्तमान sys.version मान भेजना होता है। यह तंत्र इस बात से बचाता है कि किसी और के पहले किए गए संशोधित संस्करण के ऊपर लिखा न जाए।
  • आंशिक संपादन PATCH से. केवल कुछ फ़ील्ड बदलते समय RFC 6902 JSON Patch बॉडी के साथ PATCH भेजते हैं। ऐसे में अनुरोध का Content-Type application/json-patch+json होता है। पूरी बॉडी से प्रतिस्थापित करने पर PUT का उपयोग होता है।
  • प्रकाशित करने पर ही पहुँचता है. Content, Media और Content Type को CMA में बनाने या संपादित करने के बाद प्रकाशित (Publish) करने पर ही CDA तक पहुँचाया जाता है। प्रकाशन से पहले का Draft या अप्रकाशित बदलाव कंटेंट स्टूडियो और CMA में दिखते हैं, पर डिलीवरी मार्ग पर नहीं चढ़ते।
  • प्रतिक्रिया मीडिया प्रकार. प्रतिक्रिया का Content-Type application/vnd.com.weegloo.v1+json;charset=UTF-8 होता है। अनुरोध में Accept: application/json भेजने पर निगोशिएशन विफल हो सकता है, इसलिए Accept को छोड़ दें या वही vendor प्रकार उपयोग करें।

सूची चयन के पैरामीटर (limit, order, include, select, फ़िल्टर, कर्सर पेजिनेशन), sys ढाँचा, और एरर कोड जैसे सामान्य नियम सामान्य क्वेरी पैरामीटर, सिस्टम गुण (sys), नियम और एरर में कवर किए गए हैं।

संसाधन

कंटेंट

  • Content Type: वह ढाँचा (स्कीमा) परिभाषित करता है जिसका कंटेंट पालन करता है। फ़ील्ड संरचना, प्रकार, बहुभाषी होना या न होना, अनिवार्य होना या न होना, और वैधता नियम तय करता है।
  • Content: Content Type से ढले वास्तविक डेटा की एक प्रविष्टि को बनाता और संपादित व प्रकाशित करता है।
  • Media: अपलोड की गई फ़ाइलों (छवि, दस्तावेज़ आदि) को रखने वाले संसाधन का प्रबंधन करता है।
  • Tag: Content या Media को वर्गीकृत करने वाले छोटे लेबल का प्रबंधन करता है।
  • Locale: Space द्वारा समर्थित भाषा सेटिंग (code, डिफ़ॉल्ट है या नहीं, fallbackCode) का प्रबंधन करता है।

स्पेस व संगठन, अनुमतियाँ

  • Organization: Space को रखने वाला सर्वोच्च पात्र है। सब्सक्रिप्शन प्लान (plan) और सदस्यता इसी स्तर पर प्रबंधित होती है।
  • Organization Membership: यह दर्शाता है कि कोई व्यक्ति किस Organization में किस अनुमति के साथ शामिल है, और ईमेल आमंत्रण से नए सदस्य जोड़ता है।
  • Space: एक प्रोजेक्ट का सारा कंटेंट जिसमें समाहित होता है, वह कार्य-स्थान है।
  • Space Membership: यह दर्शाता है कि कोई उपयोगकर्ता किस Space में किन SpaceRole के साथ शामिल है।
  • SpaceRole: Space के सदस्य को दी जाने वाली अनुमतियों का समूह है। प्रति-संसाधन कार्य (पढ़ना, बनाना, संपादन, हटाना, प्रकाशन) और दायरा फ़िल्टर इसमें समाहित होते हैं।

टोकन

  • Personal Access Token: Weegloo User द्वारा सर्वर, CI और स्क्रिप्ट में अपनी अनुमति के साथ CMA, Upload और CDA को कॉल करते समय उपयोग होने वाला दीर्घकालिक टोकन है।
  • Delivery Access Token: CDA से प्रकाशित कंटेंट पढ़ते समय उपयोग होने वाला पठन टोकन है। जारी करते समय इसे किसी एक SpaceRole से बाँधकर पठन दायरा तय किया जाता है।

उत्पाद सदस्य (ServiceUser)

  • ServiceLogin: वह सेटिंग है जिससे Space अपने उत्पाद के end-user (ServiceUser) को OAuth के ज़रिए साइन-अप व लॉगिन कराता है।
  • ServiceUserRole: उत्पाद में शामिल हुए ServiceUser को दी जाने वाली अनुमतियों का समूह है। यह ACMA/ACDA पर लागू होता है।
  • ServiceUser: ServiceLogin से साइन-अप किया गया उत्पाद end-user, यानी सदस्य खाता है।

वितरण व एकीकरण

  • Web Hosting: बिल्ड की गई स्टैटिक वेबसाइट को {subdomain}.weegloo.app पते पर सेवा देने वाला संसाधन है।
  • Webhook: Space में कुछ होने पर (उदाहरण के लिए Content का बनना या प्रकाशित होना) निर्दिष्ट बाहरी URL पर HTTP अनुरोध भेजने वाली सेटिंग है।
  • CDA: प्रकाशित कंटेंट को विज़िटर तक पहुँचाने वाला केवल-पढ़ने वाला API।
  • ACMA: वही प्रबंधन कार्य सदस्य (ServiceUser) पहचान के साथ करने वाला संस्करण।
  • Upload: फ़ाइल अपलोड करने के बाद उसके परिणाम को Media निर्माण से जोड़ने वाला अपलोड API।