सैंपल एपीआई प्रॉक्सी का इस्तेमाल करना

आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इस पेज पर जाएं Apigee X दस्तावेज़.
जानकारी

ज़रूरी शर्तें

आपको http://enterprise.apigee.com पर एक खाता बनाना होगा. आप साइन अप कर सकते हैं पर अपने परीक्षण खाते के लिए http://accounts.apigee.com/accounts/sign_up.

सैंपल का इस्तेमाल करने के लिए, आपके पास ये चीज़ें भी होनी चाहिए:

टूल ब्यौरा
Git ये सैंपल, GitHub पर मौजूद हैं. अगर आपने Git इंस्टॉल नहीं किया है, तो कृपया GitHub के git सेटअप के निर्देश. अगर आपको Git इंस्टॉल नहीं करना है, तो https://github.com/apigee/api-platform-samples पेज पर जाकर फ़ाइलें ब्राउज़ करें और ZIP फ़ाइल डाउनलोड करें.
Python

Apigee डिप्लॉय टूल को चलाने के लिए, Python ज़रूरी है. Python ज़्यादातर Linux में मौजूद है एनवायरमेंट, Mac पर XCode के साथ इंस्टॉल किए गए एनवायरमेंट, Windows की मशीन पर, Cygwin इंस्टॉल किए गए होने पर, और कई अन्य जगहों पर.

Python पाने के लिए, कृपया यहां जाएं: Python डाउनलोड पेज.

curl सेटअप स्क्रिप्ट के सैंपल में भी curl का इस्तेमाल किया जाता है. पक्का करें कि curl इंस्टॉल हो और अपने पाथ पर उपलब्ध (which curl कमांड चलाकर देखें कि यह यहां उपलब्ध है या नहीं आपका सिस्टम).
dos2unix अगर आप Windows पर Cygsin चला रहे हैं, तो आपको dos2unix की ज़रूरत भी पड़ सकती है उपयोगिता. (Cygwin इंस्टॉलर आपको यूटिलिटी इंस्टॉल करने देता है.)

नमूने डाउनलोड करें

सैंपल फ़ाइलों को पाने के लिए, git clone का इस्तेमाल करें. इसका उदाहरण नीचे दिया गया है:

git clone https://github.com/apigee/api-platform-samples.git

सैंपल एपीआई को इंपोर्ट और डिप्लॉय करें प्रॉक्सी

कमांड लाइन से सैंपल इंपोर्ट करें और डिप्लॉय करें:

  1. सैंपल डाउनलोड करने के बाद, /setup डायरेक्ट्री पर जाएं, जैसा कि नीचे दिए गए उदाहरण में बताया गया है:
    cd setup
  2. /setup डायरेक्ट्री में, setenv.sh फ़ाइल पर जाएं.
  3. अपना संगठन सेट करने के लिए इस फ़ाइल में बदलाव करें, अपने उपयोगकर्ता नाम से जुड़ा ईमेल पता, साथ ही, वह एनवायरमेंट (प्रोडक्शन या टेस्ट) होना चाहिए जहां आपको एपीआई प्रॉक्सी डिप्लॉय करनी हैं.
  4. setenv.sh में बदलाव करने के बाद, ये काम करें:
    sh deploy_all.sh

    यह स्क्रिप्ट आपके संगठन के लिए सभी एपीआई प्रॉक्सी सैंपल डिप्लॉय करती है. (इस प्रोसेस में तीन से चार minutes.) एपीआई प्रॉडक्ट, डेवलपर, और ऐप्लिकेशन (इनका इस्तेमाल OAuth).

  5. स्क्रिप्ट डिप्लॉयमेंट के पूरा होने के बाद, सैंपल-प्रॉक्सी डायरेक्ट्री पर जाएं. इस डायरेक्ट्री sample-proxies, आपको हर सैंपल प्रॉक्सी के लिए एक डायरेक्ट्री मिलेगी. हर एक में डायरेक्ट्री एक README.md फ़ाइल है, जिसमें सैंपल को चलाने के बारे में जानकारी दी गई है. साथ ही, इसमें दो स्क्रिप्ट सैंपल में छोटे-छोटे बदलाव करने, डिप्लॉय करने, और फिर शुरू करने में मदद करता है, ताकि आप आपने जो बदलाव किए, उनका क्या असर हुआ:
    • invoke.sh: एपीआई के डिप्लॉय किए गए वर्शन को शुरू करने के लिए यह स्क्रिप्ट चलाएं प्रॉक्सी.
    • deploy.sh: किसी भी स्क्रिप्ट को चलाने के बाद, एपीआई प्रॉक्सी को डिप्लॉय करने के लिए यह स्क्रिप्ट चलाएं बदलाव.

सैंपल एपीआई प्रॉक्सी शुरू करें

हर सैंपल प्रॉक्सी में एक शेल स्क्रिप्ट होती है जिसका इस्तेमाल एपीआई प्रॉक्सी शुरू करने के लिए किया जा सकता है उसे डिप्लॉय करने के बाद.

/sample-proxies/proxy_name डायरेक्ट्री से, फ़ॉलो किया जा रहा है:

sh invoke.sh

इससे उस प्रॉक्सी को शुरू किया जाता है जो आपके संगठन में, टेस्ट एनवायरमेंट में चल रहा होता है.

समस्या का हल

समस्या हल करने के बारे में जानकारी के लिए, यहां देखें:

नमूना एपीआई प्रॉक्सी में बदलाव करना और उनका फिर से इस्तेमाल करना

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

किसी दूसरी बैकएंड सेवा पर ले जाने के लिए, सैंपल एपीआई प्रॉक्सी में बदलाव करने के लिए, एक्सएमएल कॉन्फ़िगरेशन फ़ाइल नीचे दी गई जगह पर मौजूद है:

/apiproxy/targets/target_name.xml

उदाहरण के लिए, अपनी बैकएंड सेवा पर एपीआई पासकोड का सैंपल भेजने के लिए, इस फ़ाइल का पता लगाएं:

/apikey/apiproxy/targets/default.xml

अगर डिफ़ॉल्ट कॉन्फ़िगरेशन, http://mocktarget.apigee.net पर ले जाता है, जैसे कि:

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://mocktarget.apigee.net</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

और आपकी बैकएंड सेवा http://api.myproject.com/ पर उपलब्ध है. इसके बाद, कॉन्फ़िगरेशन को कुछ इस तरह से बदलें:

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <!-- This is where we define the target. For this sample we just use a simple URL. -->
    <URL>http://api.myproject.com/</URL>
  </HTTPTargetConnection>
</TargetEndpoint>

बदलावों को सेव करने के बाद, एपीआई प्रॉक्सी को डिप्लॉय करें. इसका उदाहरण नीचे दिया गया है:

sh deploy.sh

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