ऐप्लिकेशन रजिस्ट्रेशन कॉन्फ़िगर करना

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

डेवलपर, ऐप्लिकेशन रजिस्टर करने के लिए, डेवलपर सेवाएं पोर्टल पर 'मेरे ऐप्लिकेशन' पेज का इस्तेमाल करते हैं. डेवलपर, पोर्टल के मुख्य मेन्यू से 'मेरे ऐप्लिकेशन' पेज को ऐक्सेस करते हैं:

नया ऐप्लिकेशन रजिस्टर करने के लिए, डेवलपर 'मेरे ऐप्लिकेशन' पेज पर मौजूद 'नया ऐप्लिकेशन जोड़ें' बटन को चुनता है.

इसके बाद पोर्टल पर, डिफ़ॉल्ट ऐप्लिकेशन रजिस्ट्रेशन फ़ॉर्म दिखता है:

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

एपीआई की सेवा देने वाली कंपनी के तौर पर, ऐप्लिकेशन रजिस्ट्रेशन की प्रोसेस पर आपका पूरा कंट्रोल होता है. उदाहरण के लिए, आपके पास इन्हें कॉन्फ़िगर करने का विकल्प होता है:

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

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

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

पोर्टल पर उपलब्ध एपीआई प्रॉडक्ट के बारे में जानकारी देना

डेवलपर के पोर्टल तक पहुंचने पर, उपलब्ध एपीआई प्रॉडक्ट को बताने के दो तरीके हैं:

एपीआई प्रॉडक्ट बनाते समय ऐक्सेस लेवल तय करना

एपीआई प्रॉडक्ट बनाते समय, आपको प्रॉडक्ट के लिए ऐक्सेस लेवल का विकल्प चुनना होता है, जैसा कि यहां दिखाया गया है:

Drupal 7 डेवलपर पोर्टल में, ऐक्सेस लेवल, एपीआई प्रॉडक्ट की उपलब्धता पर कैसे असर डालता है, इस बारे में ज़्यादा जानकारी के लिए, ऐक्सेस लेवल देखें.

भूमिकाओं के आधार पर किसी एपीआई प्रॉडक्ट के ऐक्सेस पर पाबंदी लगाना

एपीआई प्रॉडक्ट रोल ऐक्सेस Drupal मॉड्यूल को चालू करके, आप उन भूमिकाओं को तय कर सकते हैं जो हर एपीआई प्रॉडक्ट को ऐक्सेस कर सकती हैं.

डेवलपर की भूमिकाओं के आधार पर, किसी एपीआई प्रॉडक्ट के ऐक्सेस पर पाबंदी लगाने के लिए:

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

यह कॉन्फ़िगर करना कि डेवलपर किसी ऐप्लिकेशन में एपीआई प्रॉडक्ट को कैसे जोड़ता है

नया ऐप्लिकेशन रजिस्टर करने के लिए, डेवलपर 'मेरे ऐप्लिकेशन' पेज पर मौजूद 'नया ऐप्लिकेशन जोड़ें' बटन को चुनकर, ऐप्लिकेशन जोड़ें फ़ॉर्म को खोलता है:

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

ऐप्लिकेशन को रजिस्टर करते समय, एपीआई प्रॉडक्ट चुनने के तरीके को कंट्रोल करने के लिए, पोर्टल पर कॉन्फ़िगरेशन के ये विकल्प उपलब्ध हैं:

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

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

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

एपीआई प्रॉडक्ट चुनने का विकल्प सेट करने के लिए:

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

कॉलबैक यूआरएल हैंडलिंग को कॉन्फ़िगर करना

अगर आपके एपीआई प्रॉडक्ट में एपीआई प्रॉक्सी के तौर पर "थ्री-लेग्ड OAuth" (ऑथराइज़ेशन कोड ग्रांट टाइप) का इस्तेमाल किया जाता है, तो ऐप्लिकेशन रजिस्टर करते समय डेवलपर को कॉलबैक यूआरएल तय करना होगा. आम तौर पर, कॉलबैक यूआरएल उस ऐप्लिकेशन के यूआरएल के बारे में बताता है जिसे क्लाइंट ऐप्लिकेशन की ओर से ऑथराइज़ेशन कोड पाने के लिए तय किया जाता है. इसके अलावा, इस यूआरएल स्ट्रिंग का इस्तेमाल पुष्टि के लिए किया जाता है. ऑथराइज़ेशन कोड और ऐक्सेस टोकन का अनुरोध करते समय, क्लाइंट को यह यूआरएल Apigee Edge को भेजना होगा. साथ ही, redirect_uri पैरामीटर, रजिस्टर किए गए यूआरएल से मेल खाना चाहिए. ज़्यादा जानकारी के लिए, ऑथराइज़ेशन कोड के ऐक्सेस का टाइप लागू करना लेख देखें.

एपीआई प्रॉडक्ट चुनने के लिए कॉलबैक यूआरएल को कंट्रोल करने के लिए:

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

ऐप्लिकेशन के इस्तेमाल के आंकड़े दिखाए जा रहे हैं

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

  • प्रवाह क्षमता
  • जवाब देने में लगने वाला ज़्यादा से ज़्यादा समय
  • जवाब देने में लगने वाला कम से कम समय
  • मैसेज की संख्या
  • गड़बड़ी की संख्या

पोर्टल पर आंकड़े पाने की सुविधा चालू करने के लिए:

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

पोर्टल पर किसी ऐप्लिकेशन के आंकड़े दिखाने के लिए:

  1. मेरे ऐप्लिकेशन पेज पर ऐप्लिकेशन का नाम चुनें.
  2. ऐप्लिकेशन के लिए Analytics लिंक चुनें.
  3. दिखाए जाने के लिए आंकड़े का टाइप और तारीख की सीमा चुनें:
  4. चुनी गई जानकारी दिखती है:

एपीआई प्रॉडक्ट के लिए, एपीआई पासकोड को मैन्युअल तरीके से अनुमति देना या उसे रद्द करना

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

एपीआई प्रॉडक्ट बनाते समय, हर एपीआई प्रॉडक्ट के लिए कुंजी को अनुमति देने की प्रोसेस को कंट्रोल किया जा सकता है:

मंज़ूरी की प्रोसेस इनमें से कोई भी हो सकती है:

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

ज़्यादा जानकारी के लिए, एपीआई प्रॉडक्ट बनाना लेख पढ़ें.

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

किसी ऐप्लिकेशन के एपीआई प्रॉडक्ट की सूची और एपीआई प्रॉडक्ट के लिए कुंजी को मंज़ूरी मिलने की स्थिति देखने के लिए, डेवलपर 'मेरे ऐप्लिकेशन' पेज पर ऐप्लिकेशन का नाम चुनता है और फिर 'प्रॉडक्ट' लिंक चुनता है:

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

किसी कुंजी को मैन्युअल तरीके से मंज़ूरी देने या रद्द करने के लिए:

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

  5. उस ऐप्लिकेशन का नाम चुनें जिसे अनुमति देनी है.
  6. ऐप्लिकेशन की ज़्यादा जानकारी वाले पेज पर, सबसे ऊपर दाएं कोने में मौजूद बदलाव करें बटन को चुनें.
  7. ऐप्लिकेशन के लिए एपीआई प्रॉडक्ट की सूची में, कार्रवाइयां में जाएं:
    • कुंजी को अनुमति देने के लिए, एपीआई के हर उस प्रॉडक्ट के लिए मंज़ूरी दें बटन को चुनें जिसके लिए मैन्युअल तौर पर मंज़ूरी की ज़रूरत है.

    • मंज़ूरी दी गई कुंजी को रद्द करने के लिए, ऐक्सेस रद्द करने के लिए, 'एपीआई की कार्रवाइयां' प्रॉडक्ट में दिए गए रद्द करें बटन को चुनें.

  8. ऐप्लिकेशन सेव करें. एपीआई पासकोड को अब मंज़ूरी मिल गई है.

एपीआई प्रॉडक्ट और ऐप्लिकेशन की कैश मेमोरी को कंट्रोल करना

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

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

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

हर बार क्रॉन चलने पर, एपीआई प्रॉडक्ट और डेवलपर ऐप्लिकेशन की कैश मेमोरी को फिर से बनाना है या नहीं, यह तय करने के लिए:

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

कैश मेमोरी को मैन्युअल तरीके से अपडेट करने के लिए:

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

ऐप्लिकेशन को रजिस्टर करने के लिए इस्तेमाल किए जाने वाले फ़ॉर्म फ़ील्ड को पसंद के मुताबिक बनाना

जब डेवलपर किसी ऐप्लिकेशन को रजिस्टर करता है, तो पोर्टल में यह डिफ़ॉल्ट फ़ॉर्म दिखता है:

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

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

डेवलपर पोर्टल पर उपलब्ध ऐप्लिकेशन रजिस्ट्रेशन फ़ॉर्म को अपनी पसंद के मुताबिक बनाने का तरीका जानने के लिए, यह वीडियो देखें.

उदाहरण के लिए, नीचे दिए गए फ़ॉर्म में ग्राहक आईडी के लिए ज़रूरी फ़ील्ड और टारगेट प्लैटफ़ॉर्म के लिए एक वैकल्पिक फ़ील्ड दिखाया गया है:

जब फ़ॉर्म में नए फ़ील्ड जोड़े जाते हैं, तब फ़ील्ड की वैल्यू Edge में अपने-आप अपलोड हो जाती हैं. साथ ही, जब डेवलपर फ़ॉर्म सबमिट करता है, तो बाकी सभी फ़ील्ड की वैल्यू भी अपने-आप अपलोड हो जाती है. इसका मतलब है कि आप Edge पर उन फ़ील्ड को देख सकते हैं या उनमें बदलाव कर सकते हैं. इसके अलावा, इन फ़ील्ड को किसी स्क्रिप्ट से ऐक्सेस करने के लिए, Edge management API का इस्तेमाल कर सकते हैं.

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

फ़ील्ड की वैल्यू, डेवलपर के 'मेरे ऐप्लिकेशन' पेज पर ऐप्लिकेशन के ज़्यादा जानकारी वाले सेक्शन में भी दिखाई जाती हैं:

डेवलपर, 'मेरे ऐप्लिकेशन' पेज पर मौजूद ऐप्लिकेशन के लिए 'बदलाव करें' लिंक चुनकर, वैल्यू में बदलाव भी कर सकते हैं.

नीचे दी गई प्रोसेस में बताया गया है कि एडमिन इंटरफ़ेस का इस्तेमाल करके, ऐप्लिकेशन बनाने के फ़ॉर्म कैसे कॉन्फ़िगर किए जाएं. Drupal डेवलपर अपनी पसंद के मुताबिक अन्य काम कर सकता है. इनमें कस्टम हुक का इस्तेमाल करके, 'मेरे ऐप्लिकेशन' पेज में बदलाव करना भी शामिल है. कोड की मदद से, ऐप्लिकेशन के व्यवहार को कैसे बदला जाता है, इस बारे में ज़्यादा जानने के लिए, फ़ाइल में ऐप्लिकेशन एपीआई के उदाहरण देखें: /profiles/apigee/modules/custom/devconnect/devconnect_developer_apps/devconnect_developer_apps.api.php.

ऐप्लिकेशन रजिस्ट्रेशन फ़ॉर्म में कोई फ़ील्ड जोड़ने के लिए:

  1. अपने पोर्टल पर एडमिन या कॉन्टेंट बनाने के खास अधिकार वाले उपयोगकर्ता के तौर पर लॉग इन करें.
  2. पक्का करें कि DevConnect ऐप्लिकेशन एट्रिब्यूट मैनेजमेंट मॉड्यूल चालू हो.
  3. Drupal के एडमिन मेन्यू में, कॉन्फ़िगरेशन > डेव पोर्टल सेटिंग > डेव पोर्टल ऐप्लिकेशन के एट्रिब्यूट चुनें.
  4. पेज पर सबसे ऊपर मौजूद, डेव पोर्टल ऐप्लिकेशन एट्रिब्यूट जोड़ें बटन चुनें.
  5. फ़ील्ड को कॉन्फ़िगर करें. उदाहरण के लिए, ऊपर दिखाए गए ग्राहक आईडी फ़ील्ड के लिए, ये सेटिंग इस्तेमाल करें:
    • इंटरनल नेम = cust_id. यह फ़ील्ड की वैल्यू को स्टोर करने के लिए इस्तेमाल किए जाने वाले वैरिएबल का नाम है.
    • सार्वजनिक नाम = ग्राहक आईडी
    • ब्यौरा = अपना ग्राहक आईडी डालें.
    • 'यह एट्रिब्यूट ज़रूरी है' चेकबॉक्स को चुनें
    • यह एट्रिब्यूट दिखाने के लिए चेक बॉक्स चुनें.
    • विजेट = टेक्स्ट बॉक्स
    • Dev पोर्टल ऐप्लिकेशन एट्रिब्यूट पेज पर वापस जाने के लिए, 'सेव करें' चुनें.
  6. बदलाव सेव करें को चुनें.
  7. Drupal मेन्यू से होम आइकॉन > सभी कैश मेमोरी मिटाएं को चुनें.
    फ़ॉर्म पर नया फ़ील्ड दिखने से पहले, आपको ब्राउज़र की कैश मेमोरी मिटानी पड़ सकती है.

ऐप्लिकेशन का प्लैटफ़ॉर्म तय करने के लिए, डेवलपर एक ऐसा फ़ील्ड जोड़ें जो ज़रूरी नहीं है. इसके लिए, फ़ील्ड के एट्रिब्यूट को इस तरह सेट करें:

  • इंटरनल नेम = aims_platforms
  • सार्वजनिक नाम = प्लैटफ़ॉर्म
  • ब्यौरा = अपने ऐप्लिकेशन के लिए एक या उससे ज़्यादा प्लैटफ़ॉर्म बताएं.
  • 'यह एट्रिब्यूट ज़रूरी है' के तौर पर दिए गए चेक बॉक्स से सही का निशान हटाएं
  • यह एट्रिब्यूट दिखाने के लिए चेकबॉक्स चुनें.
  • Widget = चेकबॉक्स की सूची
  • Dev पोर्टल ऐप्लिकेशन एट्रिब्यूट पेज पर वापस जाने के लिए, 'सेव करें' चुनें.

फ़ॉर्म में एट्रिब्यूट का क्रम बदलने के लिए:

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