Drupal 7 का इस्तेमाल करके अपना पोर्टल बनाएं

Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं.
जानकारी

सोशल पब्लिशिंग की सुविधाओं वाले डेवलपर पोर्टल का इस्तेमाल, डेवलपर कम्यूनिटी से बातचीत करने के लिए तेज़ी से किया जा रहा है. इसमें एपीआई के दस्तावेज़ और इस्तेमाल की शर्तों जैसे स्टैटिक कॉन्टेंट के साथ-साथ ब्लॉग और फ़ोरम जैसे समुदाय के योगदान से मिलने वाले डाइनैमिक कॉन्टेंट के बारे में जानकारी देना शामिल है.

एपीआई की सेवा देने वाली कंपनी के तौर पर, आपको एक ऐसा तरीका चाहिए जिसका इस्तेमाल करके, अपने एपीआई के बारे में लोगों को बताया जा सके, डेवलपर को अपने एपीआई के बारे में बताया जा सके, और डेवलपर को साइन अप करने की अनुमति दी जा सके. इसके अलावा, डेवलपर को ऐप्लिकेशन रजिस्टर करने की अनुमति भी देनी होती है. अपने एपीआई के बारे में डेवलपर को जानकारी देना, वाकई में डाइनैमिक कम्यूनिटी बनाने का एक हिस्सा है. आपको अपनी डेवलपर कम्यूनिटी के लिए, सुझाव/राय देने, मदद करने, और किसी सुविधा का अनुरोध करने, और अपना कॉन्टेंट सबमिट करने का एक तरीका भी चाहिए. इस कॉन्टेंट को दूसरे डेवलपर ऐक्सेस कर सकते हैं.

Apigee Edge आपको डेवलपर सेवाओं का एक पोर्टल देता है, जिसका इस्तेमाल अपनी पसंद के मुताबिक वेबसाइट बनाने और लॉन्च करने के लिए किया जा सकता है. इसकी मदद से, अपने डेवलपमेंट कम्यूनिटी को ये सभी सेवाएं दी जा सकती हैं. Edge का हर ग्राहक अपना खुद का डेवलपर पोर्टल बना सकता है, चाहे वह क्लाउड में हो या कंपनी की इमारत में.

नीचे दिए गए वीडियो में, Apigee डेवलपर सेवाओं के पोर्टल के बारे में बताया गया है.

नीचे दिया गया चित्र डिफ़ॉल्ट डेवलपर पोर्टल का होम पेज दिखाता है:

डिफ़ॉल्ट डेवलपर पोर्टल का होम पेज

डेवलपर पोर्टल एक कॉन्टेंट मैनेजमेंट सिस्टम है, जो ओपन सोर्स Drupal (http://www.drupal.org) प्रोजेक्ट पर आधारित है. Drupal, मॉड्यूल के रूप में सुविधाओं का एक मुख्य सेट उपलब्ध कराता है. इसकी मदद से, वेबसाइटों के लिए कॉन्टेंट बनाने के साथ-साथ उन्हें मैनेज भी किया जा सकता है.

बेहतरीन सुविधा देने वाले डेवलपर पोर्टल में, आपको एपीआई से जुड़े दस्तावेज़ बनाने, ब्लॉगिंग की सुविधा देने, और थ्रेड वाले फ़ोरम उपलब्ध कराने की सुविधा मिलती है. डेवलपर पोर्टल में अपनी खास ज़रूरतों को पूरा करने के लिए, उसे अपनी पसंद के मुताबिक भी बनाया जा सकता है. कस्टमाइज़ेशन से आप पोर्टल के दिखने के तरीके और डेवलपर के साथ पोर्टल के साथ इंटरैक्ट करने के तरीके में भी बदलाव कर सकते हैं.

ज़्यादातर कस्टमाइज़ेशन करने के लिए, Drupal मेन्यू का इस्तेमाल किया जाता है. अगर आप एडमिन के खास अधिकारों वाले उपयोगकर्ता के तौर पर पोर्टल में लॉग इन करते हैं, तो हर पोर्टल पेज में सबसे ऊपर Drupal मेन्यू दिखता है:

लॉग इन करने पर, पोर्टल में सबसे ऊपर Drupal मेन्यू दिखता है.

एडमिन, उस प्रोसेस को कंट्रोल करता है जिसके लिए डेवलपर, पोर्टल के ऐक्सेस का अनुरोध करते हैं. साथ ही, यह भी पता चलता है कि डेवलपर आपके एपीआई ऐक्सेस करने वाले ऐप्लिकेशन को कैसे रजिस्टर करते हैं, डेवलपर को अपने एपीआई से जुड़ी खास भूमिकाएं और अनुमतियां कैसे असाइन करते हैं, और डेवलपर को एपीआई का ऐक्सेस कब रद्द करना है.

कमाई करने की सुविधा को कॉन्फ़िगर और कंट्रोल करने के लिए भी डेवलपर पोर्टल का इस्तेमाल किया जाता है. कमाई करने की सुविधा चालू होने पर, डेवलपर को डेवलपर पोर्टल के ज़रिए खुद ही बिलिंग और रिपोर्ट, कैटलॉग और प्लान का ऐक्सेस मिल जाता है. साथ ही, कमाई करने से जुड़ी खास सेटिंग का ऐक्सेस भी मिल जाता है.

पोर्टल इस्तेमाल करने वाले लोगों के टाइप

नीचे दी गई इमेज में पोर्टल के दो तरह के उपयोगकर्ताओं को दिखाया गया है:

पोर्टल के दो तरह के उपयोगकर्ता: डेवलपर और टीम. वे जो टास्क कर सकते हैं उनकी जानकारी नीचे दिखाई गई है. साथ ही, उसके बारे में भी पूरी जानकारी दी गई है.

  • डेवलपर, उन उपयोगकर्ताओं की कम्यूनिटी बनाते हैं जो आपके एपीआई का इस्तेमाल करके, ऐप्लिकेशन बनाते हैं. ऐप्लिकेशन डेवलपर, SmartDocs की मदद से आपके एपीआई के बारे में जानने, पोर्टल पर कोई खाता रजिस्टर करने, आपके एपीआई का इस्तेमाल करने वाले ऐप्लिकेशन रजिस्टर करने, डेवलपर समुदाय से इंटरैक्ट करने, और डैशबोर्ड पर उनके ऐप्लिकेशन के इस्तेमाल के बारे में आंकड़ों की जानकारी देखने के लिए इस पोर्टल का इस्तेमाल करते हैं.
  • एपीआई टीम, एपीआई की सुविधा देने वाली वह कंपनी है जो पोर्टल कॉन्टेंट बनाती है, अपने एपीआई ऐप्लिकेशन डेवलपर को उपलब्ध कराती है, एपीआई से जुड़े दस्तावेज़ उपलब्ध कराती है, और डेवलपर को ऐप्लिकेशन रजिस्टर करने और एपीआई कुंजियां पाने का तरीका उपलब्ध कराती है. एपीआई टीम, डेवलपर पोर्टल को बुनियादी तौर पर कॉन्फ़िगर करती है, ताकि:
    • एपीआई पासकोड के लिए, अपने-आप जनरेट होने वाले या मैन्युअल अनुरोधों को कॉन्फ़िगर करना
    • API दस्तावेज़, फ़ोरम, और ब्लॉग बनाए रखें और सभी बदलावों में वैकल्पिक रूप से बदलाव करें
    • उपयोगकर्ता की टिप्पणियों और फ़ोरम को मॉडरेट करना
    • पोर्टल पर सुविधाओं का ऐक्सेस कंट्रोल करने के लिए, रोल के हिसाब से ऐक्सेस कंट्रोल (आरबीएसी) लागू करें. उदाहरण के लिए, एडमिन रजिस्टर्ड उपयोगकर्ता को फ़ोरम पोस्ट बनाने या टेस्ट कंसोल इस्तेमाल करने की अनुमति देने के लिए कंट्रोल चालू कर सकता है
    • उपयोगकर्ता बनाने और अनुमति देने के लिए, एडमिन और डेवलपर, दोनों के लिए ईमेल सूचनाओं को पसंद के मुताबिक बनाएं
    • वेब फ़ॉर्म को पसंद के मुताबिक बनाएं, जैसे कि "हमसे संपर्क करें" पेज

इस इमेज में दिखाया नहीं गया है. यह तीसरे तरह का पोर्टल उपयोगकर्ता है - एपीआई प्रॉडक्ट मैनेजर. यह तय करना एपीआई प्रॉडक्ट मैनेजर की ज़िम्मेदारी है कि एपीआई टीम, पोर्टल को कैसे बनाए . पोर्टल में ये चीज़ें शामिल हैं:

  • प्रॉडक्ट में एपीआई को पैकेज करने का तरीका तय करना
  • ऐप्लिकेशन की मंज़ूरी के लिए नियम तय करना
  • अगर पोर्टल पर कमाई करने की सुविधा चालू की गई है, तो एपीआई प्रॉडक्ट के लिए कीमतें और बिलिंग प्लान तय करें. कमाई करने के बारे में ज़्यादा जानने के लिए, कमाई करने से जुड़ी खास जानकारी देखें.

डेवलपर पोर्टल को पसंद के मुताबिक बनाना

एपीआई सेवा देने वाली कंपनी के तौर पर, डेवलपर पोर्टल को अपनी पसंद के मुताबिक बनाने का तरीका सोचें, ताकि वह आपके एपीआई के साथ सबसे सही तरीके से काम करे. साथ ही, आपके डेवलपर समुदाय को एपीआई इस्तेमाल करने के लिए ज़रूरी जानकारी दी जाए. अपने कस्टम पोर्टल के लिए कुछ ज़रूरी बातें:

  • आपके एपीआई को आसानी से ऐक्सेस करें
  • दस्तावेज़, जैसे कि इस्तेमाल करने का तरीका बताने वाले दस्तावेज़ और रेफ़रंस दस्तावेज़
  • समुदाय के योगदान से बना कॉन्टेंट, जैसे कि ब्लॉग और चर्चा के लिए फ़ोरम
  • नमूना कोड
  • एक आसान साइन-अप प्रोसेस, जहां नए डेवलपर, ऐप्लिकेशन, और एपीआई को तुरंत मंज़ूरी दी जा सकती है
  • प्रबंधित अधिकार और क्रेडेंशियल
  • अलग-अलग लेवल वाला ऐक्सेस कंट्रोल
  • ऐसा रंग-रूप जो आपके संगठन से मेल खाता हो

पोर्टल में बुनियादी कॉन्फ़िगरेशन पहले से तय होता है. उदाहरण के लिए, सभी लोगों को डेवलपर के तौर पर रजिस्टर करने की अनुमति देने के लिए पोर्टल को अजीब तरीके से कॉन्फ़िगर किया गया है. हालांकि, पोर्टल में लॉग इन करने से पहले, एडमिन को हर रजिस्ट्रेशन को मंज़ूरी देनी होगी. रजिस्ट्रेशन की अनुमति मिलने के बाद, डेवलपर एपीआई पासकोड के लिए अनुरोध करने के लिए, किसी ऐप्लिकेशन को रजिस्टर कर सकता है. साथ ही, एपीआई के रिसॉर्स ऐक्सेस करने के लिए पोर्टल का इस्तेमाल कर सकता है.

डिफ़ॉल्ट रजिस्ट्रेशन प्रोसेस के चरण ये हैं:

  1. डेवलपर, डेवलपर पोर्टल से रजिस्टर करता है. इसके जवाब में, पोर्टल एडमिन को खाते को मंज़ूरी देने के लिए एक ईमेल भेजता है.
  2. एडमिन खाते को मंज़ूरी देता है. इसके बाद, डेवलपर को एक ईमेल भेजा जाता है जिसमें उन्हें बताया जाता है कि अब वे लॉग इन कर सकते हैं.
  3. डेवलपर एक ऐप्लिकेशन रजिस्टर करता है और ऐप्लिकेशन के लिए इस्तेमाल किए गए एपीआई प्रॉडक्ट चुनता है. इसके जवाब में, पोर्टल ऐप्लिकेशन को एक यूनीक एपीआई पासकोड असाइन करता है.
  4. डेवलपर आपके एपीआई के लिए अनुरोध करते समय, एपीआई पासकोड पास करता है.

इस अनोखे इंटरफ़ेस को अपनी पसंद के मुताबिक बनाया जा सकता है. उदाहरण के लिए, आपके पास डिफ़ॉल्ट रजिस्ट्रेशन और ऑथराइज़ेशन स्कीम को बदलने की सुविधा होती है. इससे, नए डेवलपर को अपने-आप मंज़ूरी मिल जाती है और वह रजिस्ट्रेशन के बाद लॉग इन कर लेता है. इसके अलावा, पहली बार लॉग इन करने से पहले, डेवलपर को कुछ नियमों और शर्तों को स्वीकार करने के लिए कहा जा सकता है.

डेवलपर पोर्टल पर उपलब्ध कॉन्टेंट पर भी आपका पूरा कंट्रोल होता है. सबसे अलग सुविधा वाले डेवलपर पोर्टल में, एपीआई दस्तावेज़, ब्लॉग पोस्ट, और फ़ोरम में होने वाली चर्चाओं जैसा सैंपल कॉन्टेंट दिखाया जाता है. आपके पास अपना कॉन्टेंट देने का विकल्प होता है. साथ ही, यह तय किया जा सकता है कि हर कॉन्टेंट टाइप कैसा दिखे.

ज़्यादा जानकारी के लिए, थीम को पसंद के मुताबिक बनाएं देखें.

डेवलपर पोर्टल का प्रबंधन करना

डेवलपर आपके डेवलपर पोर्टल का इस्तेमाल करके, आपके एपीआई को ऐक्सेस और इस्तेमाल करते हैं. एडमिन, खाते के मैनेजमेंट के काम करते हैं, जैसे:

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

ज़्यादा जानकारी के लिए, उपयोगकर्ता खाते जोड़ना और मैनेज करना देखें.

डेवलपर पोर्टल की सुविधाओं के बारे में खास जानकारी

यहां दी गई टेबल में, डेवलपर पोर्टल की सुविधाओं की खास जानकारी दी गई है:

सुविधा ब्यौरा
ब्राउज़र समर्थन

साथ काम करने वाले सॉफ़्टवेयर और इसके साथ काम करने वाले वर्शन देखें.

उपयोगकर्ता रजिस्ट्रेशन

  • नए डेवलपर खातों के लिए मैन्युअल तरीके से या अपने-आप मंज़ूरी मिलना
  • OpenID इंटिग्रेशन
  • Twitter, Google, और GitHub के साथ सिंगल साइन-ऑन (SSO) सहायता
  • कैप्चा
  • कस्टम फ़ील्ड

यूज़र मैनेजमेंट

  • उपयोगकर्ता बनाना और उनमें बदलाव करना
  • भूमिकाएं असाइन करें

पोर्टल कैसा दिखेगा

  • सीएसएस, इमेज, और Drupal के मॉड्यूल से पसंद के मुताबिक बनाएं

कॉन्टेंट और कम्यूनिटी मैनेजमेंट

  • ओपन सोर्स (Drupal) पर आधारित
  • टेंप्लेट के आधार पर कॉन्टेंट बनाना
  • एपीआई के दस्तावेज़, ब्लॉग, फ़ोरम, और अक्सर पूछे जाने वाले सवालों के लिए, अलग-अलग तरह का कॉन्टेंट टाइप उपलब्ध है
  • Del.icio.us, Digg, Twitter के लिए स्वचालित लिंक
  • कॉन्टेंट में बदलाव करने की सेटिंग
  • ब्लॉग के लिए टैग, कीवर्ड, और संग्रह
  • Google Analytics के साथ इंटिग्रेशन
  • कॉन्टेंट के लिए, पसंद के मुताबिक लोकप्रियता की शर्तें
  • एडमिन ने फ़ोरम पोस्ट और टिप्पणियों को मॉडरेट किया है
  • कस्टम रोल, साइन इन किए हुए, और पहचान छिपाने वाले उपयोगकर्ता के आधार पर अलग-अलग ऐक्सेस

अनुमतियां

  • भूमिका के हिसाब से ऐक्सेस करने के नियम

एपीआई पासकोड मैनेज करना

  • पहले से मौजूद ऐप्लिकेशन रजिस्ट्रेशन
  • API पासकोड अपने-आप या मैन्युअल तरीके से मंज़ूरी मिलने के लिए सहायता
  • एडमिन कुंजियों को वापस ले सकते हैं

ईमेल

  • अपना एसएमटीपी सर्वर तय करें
  • कॉन्फ़िगर करें कि पोर्टल से डेवलपर को कब ईमेल भेजा जाएगा
  • पोर्टल के ज़रिए जनरेट किए गए ईमेल की सामग्री और फ़ॉर्मैट को नियंत्रित करें

ब्लॉग

  • ब्लॉग पोस्ट बनाना, उनमें बदलाव करना, और उन्हें सार्वजनिक करना
  • खास तरह के उपयोगकर्ताओं के लिए ब्लॉग बनाने पर पाबंदी लगाने के लिए, भूमिका के हिसाब से अनुमतियां

फ़ोरम

  • थ्रेड वाले डेवलपर फ़ोरम बनाना
  • ज़रूरत के हिसाब से अतिरिक्त फ़ोरम कैटगरी बनाएं
  • रोल के हिसाब से मॉडरेशन

दस्तावेज़

  • अपने एपीआई का दस्तावेज़ बनाएं
  • अक्सर पूछे जाने वाले सवाल
  • उदाहरण
  • ट्यूटोरियल

मेन्यू

  • मेन्यू के दिखने का तरीका और कॉन्टेंट को कंट्रोल करना

रिपोर्ट में खोजना

  • पहले से मौजूद Apache समाधान खोज की सुविधा
  • कोई खास कॉन्टेंट खोजें. उदाहरण के लिए, फ़ोरम या ब्लॉग
  • Google की, इंडेक्स करने की प्रोसेस को कंट्रोल करना

लिंक जांचने वाली स्क्रिप्ट

  • काम न करने वाले लिंक के लिए पेजों की जांच करें.
  • लिंक की जांच की सूची को कंट्रोल करना