शब्दावली

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

Apigee में कई ऐसे कॉन्सेप्ट हैं जो सामान्य आइडिया हैं, लेकिन इनका मतलब अलग है.

शब्द	परिभाषा
एपीआई	एक प्रॉक्सी, जो आपके मौजूदा एपीआई के लिए फ़साड के तौर पर काम करती है. डेवलपर, आपके मौजूदा एपीआई को कॉल करने के बजाय, Apigee से जनरेट किए गए नए एपीआई को कॉल करना शुरू कर देते हैं. यह फ़साड, आपके सार्वजनिक इंटरफ़ेस को आपके बैकएंड एपीआई से अलग करता है. इससे डेवलपर को बैकएंड में होने वाले बदलावों से सुरक्षा मिलती है. साथ ही, इससे आपको अपनी इंटरनल डेवलपमेंट टीमों पर असर डाले बिना, एज पर नई सुविधाएं उपलब्ध कराने में मदद मिलती है. बैकएंड में बदलाव करने पर, डेवलपर बिना किसी रुकावट के उसी एपीआई को कॉल करते रहते हैं. ज़्यादा बेहतर स्थितियों में, Apigee आपको एक ही एपीआई के लिए कई इंटरफ़ेस उपलब्ध कराने की सुविधा देता है. इससे आपको एक ही समय में, डेवलपर की अलग-अलग ज़रूरतों को पूरा करने के लिए, एपीआई के सिग्नेचर को पसंद के मुताबिक बनाने की सुविधा मिलती है.
एपीआई का बेस पाथ और संसाधन	एपीआई में बेस पाथ और संसाधनों का एक सेट होता है. इसे संसाधन पाथ भी कहा जाता है. हर एपीआई के लिए, एक रूट यूआरएल और कई संसाधन पाथ तय किए जाते हैं. एपीआई को यूआरआई का एक सेट माना जा सकता है. इन सभी यूआरआई का बेस पाथ एक जैसा होता है. अपने एपीआई को आसानी से मैनेज करने के लिए, Apigee इन रॉ यूआरआई में डिसप्ले नेम और ब्यौरे जोड़ता है.
एपीआई उपभोक्ता	"ऐप्लिकेशन डेवलपर" के लिए इस्तेमाल किया जाने वाला दूसरा शब्द. यह एपीआई उपलब्ध कराने वाली कंपनी के बनाए गए एपीआई का इस्तेमाल करता है.
एपीआई डेवलपर	एपीआई उपलब्ध कराने वाले संगठन में काम करने वाला सॉफ़्टवेयर इंजीनियर, जो एपीआई बनाता है. इन एपीआई का इस्तेमाल, ऐप्लिकेशन डेवलपर (एपीआई उपभोक्ता) ऐप्लिकेशन बनाने के लिए करते हैं.
एपीआई पैकेज	एपीआई प्रॉडक्ट का ऐसा कलेक्शन जो डेवलपर को बंडल के तौर पर दिखाया जाता है. साथ ही, यह आम तौर पर किसी रेट प्लान से जुड़ा होता है.
एपीआई प्रॉडक्ट	एपीआई संसाधनों (यूआरआई) का एक कलेक्शन, जिसे सेवा योजना के साथ मिलाकर डेवलपर को बंडल के तौर पर दिखाया जाता है. एपीआई प्रॉडक्ट में, आपके कारोबार से जुड़ा कुछ मेटाडेटा भी शामिल हो सकता है. इसका इस्तेमाल निगरानी या आंकड़ों के लिए किया जाता है. एक या एक से ज़्यादा संसाधनों से कमाई की जा सकती है. इसके लिए, उन्हें एपीआई प्रॉडक्ट में शामिल करना होगा. इसके बाद, कमाई करने के लिए उन्हें एपीआई पैकेज में बंडल किया जा सकता है.
एपीआई उपलब्ध कराने वाली कंपनी	एपीआई उपलब्ध कराने वाली कंपनी, एपीआई का इस्तेमाल करने वालों (ऐप्लिकेशन डेवलपर) के लिए एपीआई बनाती है. इसके लिए, Edge का इस्तेमाल किया जाता है.
ऐप्लिकेशन डेवलपर	Edge में, ऐप्लिकेशन डेवलपर अपने ऐप्लिकेशन को एपीआई सेवा देने वाली कंपनी के साथ रजिस्टर करते हैं. इससे ऐप्लिकेशन डेवलपर को वे एपीआई पासकोड मिलते हैं जिनकी मदद से वे सेवा देने वाली कंपनी की एपीआई प्रॉक्सी को कॉल कर पाते हैं.
ऐप्लिकेशन	आपके डेवलपर, आपके एपीआई प्रॉडक्ट में मौजूद संसाधनों को ऐक्सेस करने के लिए ऐप्लिकेशन का इस्तेमाल करते हैं. ऐप्लिकेशन बनाते समय, आपको शामिल करने के लिए एपीआई प्रॉडक्ट चुनना होता है. इसके बाद, Apigee एक कुंजी जनरेट करता है. हर ऐप्लिकेशन के लिए एक ही कुंजी होती है. इससे कई एपीआई प्रॉडक्ट को ऐक्सेस किया जा सकता है. ऐप्लिकेशन की मदद से, यह कंट्रोल किया जा सकता है कि कौन आपके संसाधनों को ऐक्सेस कर सकता है. आपके पास यह कंट्रोल करने का विकल्प होता है कि आपके एपीआई प्रॉडक्ट को कौन ऐक्सेस कर सकता है. इसके लिए, किसी ऐप्लिकेशन की कुंजी को रद्द किया जा सकता है और उसे रीफ़्रेश किया जा सकता है. इसके अलावा, ऐप्लिकेशन में मौजूद प्रॉडक्ट का ऐक्सेस रद्द करके या उसे मिटाकर, संसाधनों के बंडलों के ऐक्सेस को कंट्रोल किया जा सकता है.
बाकी बचे पैसे की जानकारी	प्रीपेड डेवलपर के लिए, डेवलपर के खाते में मौजूद बैलेंस.
बंद किया गया अडजस्टमेंट	ऐसा अडजस्टमेंट जिसे पब्लिश किए गए बिलिंग दस्तावेज़ों में लागू किया गया है.
बिलिंग का महीना खत्म हो गया है	पूरे कैलेंडर महीने के लिए, बिलिंग के दस्तावेज़ पब्लिश किए गए हों.
कस्टम सीमा	कोई सीमा (जैसे, एपीआई प्रॉडक्ट पर लेन-देन की संख्या की सीमा), जिसे कमाई करने की सुविधा का इस्तेमाल करके साफ़ तौर पर सेट अप किया जा सकता है. इसे साफ़ तौर पर तय की गई सीमा भी कहा जाता है.
डेवलपर कैटगरी के लिए रेट प्लान	यह एक ऐसा रेट प्लान है जो किसी कैटगरी के सभी डेवलपर पर लागू होता है. साथ ही, इस कैटगरी के सभी डेवलपर इसे खरीद सकते हैं.
डेवलपर के लिए रेट प्लान	ऐसा रेट प्लान जो किसी डेवलपर पर लागू होता है और जिसे सिर्फ़ वही डेवलपर खरीद सकता है.
एजेंट की जानकारी ज़ाहिर की गई	व्यापारिक कानून में, एक ऐसा व्यक्ति जिसे किसी दूसरे व्यक्ति (जिसे प्रिंसिपल कहा जाता है) की ओर से तीसरे पक्ष के साथ कानूनी संबंध बनाने की अनुमति मिली हो. मुद्रीकरण के लिए, रेवेन्यू शेयर करने के प्लान के लिए टैक्स मॉडल सेट अप किया जा सकता है. इससे एपीआई उपलब्ध कराने वाली कंपनी, डेवलपर की ओर से रेवेन्यू (और शायद बिक्री कर) इकट्ठा करने के लिए, डेवलपर के एजेंट के तौर पर काम करती है.
टैक्स मॉडल की जानकारी दी गई हो	यह एक ऐसा टैक्स मॉडल है जिसमें एपीआई उपलब्ध कराने वाली कंपनी, डेवलपर के खुले तौर पर बताए गए एजेंट के तौर पर काम करती है.
माहौल	यह एपीआई के लिए, रनटाइम एक्ज़ीक्यूशन कॉन्टेक्स्ट होता है. किसी एपीआई को रनटाइम में ऐक्सेस करने से पहले, उसे किसी एनवायरमेंट में डिप्लॉय करना ज़रूरी है. Apigee संगठनों को डिफ़ॉल्ट रूप से दो एनवायरमेंट दिए जाते हैं: 'test' और 'prod'. 'test' एनवायरमेंट का इस्तेमाल आम तौर पर, टेस्टिंग के दौरान एपीआई को डिप्लॉय करने के लिए किया जाता है. 'prod' एनवायरमेंट का इस्तेमाल आम तौर पर, प्रोडक्शन के लिए एपीआई डिप्लॉय करने के लिए किया जाता है.
हाइब्रिड टैक्स मॉडल	यह एक ऐसा टैक्स मॉडल है जिसमें एपीआई उपलब्ध कराने वाली कंपनी, डेवलपर के खुले तौर पर बताए गए एजेंट के तौर पर काम करती है. हालांकि, एपीआई सेवा देने वाली कंपनी, डेवलपर की ओर से उसके सदस्यों से इकट्ठा किया गया सेल्स टैक्स, स्थानीय टैक्स विभाग को चुकाती है.
इंप्लिसिट सीमा	कमाई करने से जुड़ी कोई सीमा (जैसे, डेवलपर के प्रीपेड बैलेंस की सीमा).
कमाई करना	Apigee Edge Developer Services का एक कॉम्पोनेंट, जो एपीआई प्रॉडक्ट से कमाई करने का आसान और फ़्लेक्सिबल तरीका उपलब्ध कराता है.
हर महीने इस्तेमाल की गई रकम	किसी डेवलपर के लिए, किसी महीने के दौरान इस्तेमाल की गई कुल रकम. इसमें सेटअप शुल्क + लेन-देन शुल्क + बार-बार लगने वाला शुल्क शामिल होता है.
हर महीने पैसे चुकाने का प्लान	खरीदे गए प्लान के आधार पर, डेवलपर की ओर से बार-बार किए जाने वाले पेमेंट. रेट प्लान में, बार-बार लगने वाला शुल्क हो सकता है. यह शुल्क, डेवलपर से हर महीने लिया जाता है. भले ही, वह सेवा का इस्तेमाल करे या न करे.
नेटिंग स्टेटमेंट	यह एक वित्तीय दस्तावेज़ है. इसमें इनवॉइस और रेवेन्यू शेयर के स्टेटमेंट के बीच का नेट बैलेंस दिखता है.
अडजस्टमेंट खोलें	ऐसा अडजस्टमेंट जिसे पब्लिश किए गए बिलिंग दस्तावेज़ों में अब तक लागू नहीं किया गया है.
ओपन बिलिंग वाला महीना	पूरे कैलेंडर महीने के लिए, “फ़ाइनल” बिलिंग दस्तावेज़ पब्लिश नहीं किए गए हैं.
संगठन	यह आपके Apigee खाते में मौजूद सभी ऑब्जेक्ट के लिए एक कंटेनर होता है. इसमें एपीआई, एपीआई प्रॉडक्ट, एपीआई पैकेज, ऐप्लिकेशन, और डेवलपर शामिल होते हैं. आपको जिस संगठन का सदस्य बनना है उसके लिए, उपयोगकर्ता खाते की ज़रूरत होती है. (ज़्यादातर उपयोगकर्ताओं के पास सिर्फ़ एक संगठन का खाता होगा.) आपको सबमिट किए गए हर एपीआई अनुरोध के साथ, अपने क्रेडेंशियल (उपयोगकर्ता नाम और पासवर्ड) और अपने संगठन का नाम देना होगा.
पैकेज कैटलॉग	एपीआई पैकेज की सूची. हर पैकेज को उसके एपीआई प्रॉडक्ट और कीमत के प्लान के साथ लिस्ट किया जाता है.
प्रीपेड बैलेंस	यह प्रीपेड डेवलपर के लिए उपलब्ध वह रकम है जिसका इस्तेमाल, एपीआई पैकेज के लिए ऐडवांस पेमेंट करने के लिए किया जा सकता है.
प्रीपेड डेवलपर	ऐसा डेवलपर जो एपीआई प्रॉडक्ट के इस्तेमाल के लिए, पहले से ही पेमेंट कर देता है. एपीआई प्रॉडक्ट का इस्तेमाल करने पर, डेवलपर के प्रीपेड बैलेंस से पैसे काट लिए जाते हैं. डेवलपर के पास, एपीआई प्रॉडक्ट खरीदने के लिए ज़रूरी प्रीपेड बैलेंस होना चाहिए. डेवलपर को एपीआई उपलब्ध कराने वाली कंपनी, प्रीपेड या पोस्टपेड स्टेटस असाइन करती है.
नीति	यह प्रोसेसिंग का एक ऐसा चरण है जो एपीआई फ़्लो में, लॉजिक की एक एटॉमिक और फिर से इस्तेमाल की जा सकने वाली यूनिट के तौर पर काम करता है. नीतियों में आम तौर पर ये शामिल होती हैं: अनुरोधों को सही एंडपॉइंट पर भेजना, मैसेज फ़ॉर्मैट बदलना, ऐक्सेस कंट्रोल लागू करना, ज़्यादा जानकारी के लिए रिमोट सेवाओं को कॉल करना, बाहरी उपयोगकर्ताओं से संवेदनशील डेटा को छिपाना, संभावित खतरों के लिए मैसेज के कॉन्टेंट की जांच करना, परफ़ॉर्मेंस को बेहतर बनाने के लिए सामान्य जवाबों को कैश मेमोरी में सेव करना वगैरह. नीतियों को किसी अनुरोध या जवाब के मैसेज के कॉन्टेंट या कॉन्टेक्स्ट के आधार पर, शर्तों के साथ लागू किया जा सकता है. उदाहरण के लिए, अगर अनुरोध वाला मैसेज किसी स्मार्टफ़ोन से भेजा गया है, तो जवाब के फ़ॉर्मैट को पसंद के मुताबिक बनाने के लिए, ट्रांसफ़ॉर्मेशन की नीति लागू की जा सकती है.
पोस्टपेड डेवलपर	ऐसा डेवलपर जिसे एपीआई प्रॉडक्ट इस्तेमाल करने के लिए, हर महीने (इनवॉइस के ज़रिए) बिल भेजा जाता है. डेवलपर, एपीआई प्रॉडक्ट के इस्तेमाल के लिए पेमेंट करता है. यह पेमेंट, इनवॉइस में शामिल प्लान के लिए तय की गई पेमेंट की शर्तों के आधार पर किया जाता है. डेवलपर को पोस्टपेड या प्रीपेड स्टेटस, एपीआई प्रोवाइडर असाइन करता है.
प्राइस पॉइंट	संभावित कीमतों की वह रेंज जिस पर किसी प्रॉडक्ट का विपणन किया जा सकता है.
रेट कार्ड वाला किराया प्लान	ऐसा रेट प्लान जिसमें डेवलपर से, कमाई करने वाले हर एपीआई प्रॉडक्ट के लेन-देन के लिए, तय या अलग-अलग दर से शुल्क लिया जाता है.
किराया प्लान	एपीआई के ऐसे पैकेज के लिए शुल्क, अन्य शुल्क, और रेवेन्यू के बंटवारे की जानकारी जिसमें एपीआई के ऐसे प्रॉडक्ट शामिल हों जिनसे कमाई की जा सकती है.
resource path	यह RESTful कॉन्सेप्ट है. रिसॉर्स पाथ, यूनिफ़ॉर्म रिसॉर्स आइडेंटिफ़ायर (यूआरआई) होता है. यह किसी दिए गए रिसॉर्स के नेटवर्क पाथ की पहचान करता है.
रेवेन्यू के बंटवारे की दर वाला प्लान	यह एक ऐसा रेट प्लान है जिसमें कमाई करने वाले एपीआई प्रॉडक्ट से जुड़े हर ट्रांजै़क्शन से मिले रेवेन्यू का कुछ हिस्सा, अनुरोध करने वाले ऐप्लिकेशन के डेवलपर के साथ शेयर किया जाता है.
रेवेन्यू का हिस्सा और रेट कार्ड प्लान	यह एक ऐसा रेट प्लान है जिसमें कमाई करने वाले एपीआई प्रॉडक्ट से जुड़े हर ट्रांजै़क्शन से मिले रेवेन्यू का कुछ हिस्सा, अनुरोध करने वाले ऐप्लिकेशन के डेवलपर के साथ शेयर किया जाता है. डेवलपर से हर लेन-देन के लिए, तय या वैरिएबल शुल्क भी लिया जाता है.
सेल्फ़-बिलिंग इनवॉइस	यह एक फ़ाइनेंशियल दस्तावेज़ है, जिसे रेवेन्यू के बंटवारे के स्टेटमेंट के बजाय जनरेट किया जाता है. इसमें डेवलपर को मिलने वाली रकम की जानकारी होती है. साथ ही, यह डेवलपर की ओर से एपीआई देने वाली कंपनी के लिए इनवॉइस के तौर पर काम करता है.
स्टैंडर्ड रेट प्लान	ऐसा रेट प्लान जिसे सभी डेवलपर खरीद सकते हैं.
कर	डेवलपर के इस्तेमाल और शुल्क पर लगाया गया कुल टैक्स.
टॉप अप करें	ऐडवांस में पैसे चुकाने वाले डेवलपर की ओर से, प्रीपेड बैलेंस में फ़ंड जोड़ने के लिए की गई कार्रवाई.
लेन-देन रिकॉर्ड करने से जुड़ी नीति	यह एक ऐसा तरीका है जिससे कमाई करने की सुविधा चालू की जा सकती है. इससे लेन-देन के पैरामीटर और कस्टम एट्रिब्यूट कैप्चर किए जा सकते हैं. Monetization को इस जानकारी की ज़रूरत होती है, ताकि वह कमाई करने से जुड़ी प्रोसेस पूरी कर सके. जैसे, हर ट्रांजै़क्शन में कैप्चर किए गए कस्टम एट्रिब्यूट के आधार पर, एपीआई अनुरोधों और जवाबों पर रेट प्लान लागू करना.
ऐसा एजेंट जिसकी जानकारी उपलब्ध न हो	कोई संगठन (या ऑपरेटर) जो ऐप्लिकेशन की सप्लाई में हिस्सा लेता है. इससे यह माना जाता है कि वह डेवलपर की ओर से कॉन्टेंट खरीदता है (सिर्फ़ टैक्स के मकसद से). एजेंट के तौर पर, संगठन (या ऑपरेटर) असली उपयोगकर्ताओं से टैक्स इकट्ठा कर सकता है और उसका हिसाब रख सकता है. यह स्टेटस सिर्फ़ टैक्स के मकसद से ज़रूरी है. इससे सप्लाई चेन में डेवलपर के कानूनी स्टेटस पर कोई असर नहीं पड़ता.
टैक्स मॉडल की जानकारी नहीं दी गई है	यह एक ऐसा टैक्स मॉडल है जिसमें एपीआई उपलब्ध कराने वाली कंपनी, असली उपयोगकर्ताओं से इकट्ठा किया गया टैक्स काट लेती है. इसके बाद, वह इसे स्थानीय टैक्स अथॉरिटी को चुकाती है.
वर्शन	डेवलपर के लिए उपलब्ध एपीआई इंटरफ़ेस का वर्शन. उदाहरण के लिए, pivotaltracker.com/services/v3 या api.enterprise.apigee.com/v1. (यह शब्द, ‘बदलाव’ से अलग है. बदलाव, कॉन्फ़िगरेशन और नीतियों का नंबर वाला, वर्शन कंट्रोल किया गया पैकेज होता है. इसे एपीआई प्रॉक्सी में बंडल किया जाता है. संक्षेप में कहें, तो एपीआई इंटरफ़ेस के वर्शन होते हैं, जबकि एपीआई प्रॉक्सी के वर्शन को संशोधन कहा जाता है.