ट्रांज़ैक्शन रिकॉर्डिंग से जुड़ी नीति कॉन्फ़िगर करना

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

नीचे दिए गए सेक्शन में बताए गए तरीके के मुताबिक, अपने एपीआई प्रॉडक्ट बंडल में, हर एपीआई प्रॉडक्ट के लिए लेन-देन रिकॉर्ड करने की नीतियों को कॉन्फ़िगर करें.

परिचय

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

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

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

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

लेन-देन रिकॉर्ड करने की नीति कॉन्फ़िगर करना

यहां बताए गए तरीके से, 'प्रॉडक्ट बंडल' पेज को ऐक्सेस करें.

Edge

Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके एपीआई प्रॉडक्ट बंडल जोड़ते समय, आपको लेन-देन रिकॉर्ड करने की नीति कॉन्फ़िगर करनी होगी इसके लिए, यह तरीका अपनाएं:

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

क्लासिक Edge (प्राइवेट क्लाउड)

क्लासिक एज यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके लेन-देन रिकॉर्ड करने की नीति को कॉन्फ़िगर करने के लिए:

  1. http://ms-ip:9000 में साइन इन करें, जहां ms-ip मैनेजमेंट सर्वर नोड का आईपी पता या डीएनएस नाम.
  2. पब्लिश करें > को चुनें सबसे ऊपर मौजूद नेविगेशन बार में मौजूद प्रॉडक्ट सेक्शन पर जाएं.
  3. लागू एपीआई की पंक्ति में + लेन-देन रिकॉर्डिंग नीति पर क्लिक करें प्रॉडक्ट. आपको लेन-देन रिकॉर्ड करने से जुड़ी नई नीति की विंडो दिखेगी.
  4. यह तरीका अपनाकर, लेन-देन का रिकॉर्ड रखने की नीति को कॉन्फ़िगर करें:
  5. सेव करें पर क्लिक करें.

लेन-देन से जुड़े एट्रिब्यूट कॉन्फ़िगर करना

लेन-देन की विशेषताएं सेक्शन में, उन शर्तों के बारे में बताएं जिनसे यह पता चलता है कि कमाई करने से जुड़ा लेन-देन सही तरीके से हुआ है.

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

    txProviderStatus == 'OK'

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

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

    शुद्ध मूल्य

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

    मुद्रा

    यह एट्रिब्यूट, रेवेन्यू के बंटवारे वाले मॉडल का इस्तेमाल करने वाले रेट प्लान के लिए ज़रूरी है. लेन-देन पर लागू होने वाली मुद्रा.

    गड़बड़ी कोड

    लेन-देन से जुड़ा गड़बड़ी कोड. यह आगे आने वाले पूरे न हो पाने वाले लेन-देन की जानकारी.

    आइटम का विवरण

    लेन-देन की जानकारी.

    टैक्स

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

उदाहरण के लिए, नीचे दी गई वैल्यू सेट करने पर, कमाई करने की सुविधा को response.reason.phrase नाम वाला वैरिएबल. अगर मान ठीक है, और कमाई करने की सीमाओं की जांच से जुड़ी नीति जब हम एपीआई प्रॉक्सी ProxyEndpoint अनुरोध के साथ अटैच करते हैं, तो कमाई करने की सुविधा इसे लेन-देन के तौर पर गिनती है.

फ़ील्ड मान
लेन-देन पूरा होने की शर्तें txProviderStatus == 'OK'
स्टेटस: एपीआई संसाधन **
स्थिति: जवाब का स्थान फ़्लो वैरिएबल
स्थिति: फ़्लो वैरिएबल response.reason.phrase

कस्टम एट्रिब्यूट कॉन्फ़िगर करना

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

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

अपने रेवेन्यू में, लेन-देन रिकॉर्ड करने की नीति में बताए गए कस्टम एट्रिब्यूट शामिल किए जा सकते हैं खास जानकारी वाली रिपोर्ट, जैसा कि इसमें कस्टम ट्रांज़ैक्शन शामिल है 'रेवेन्यू की खास जानकारी वाली रिपोर्ट' में एट्रिब्यूट का इस्तेमाल करें.

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

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

उदाहरण के लिए, अगर कॉन्टेंट की लंबाई नाम का कस्टम एट्रिब्यूट कॉन्फ़िगर किया जाता है और रिस्पॉन्स की जगह के तौर पर हेडर चुना जाता है, तो अगर एचटीटीपी कॉन्टेंट की लंबाई वाले फ़ील्ड में कॉन्टेंट की लंबाई की वैल्यू दी गई है, तो आपको Content-Length को वैल्यू के तौर पर बताना होगा.

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

  • रिज़र्व एपीआई को कॉल करने की सुविधा, जिससे यह पक्का होता है कि प्रीपेड उपयोगकर्ता के पास प्रॉडक्ट और खरीदारी के लिए फ़ंड का बंटवारा ("रिज़र्व") करता है.
  • ऐसे Charge API को कॉल करें जो प्रीपेड उपयोगकर्ता के खाते से पैसे काट लेता है.

पूरे लेन-देन को प्रोसेस करने के लिए, कमाई करने के लिए पहले संसाधन को लिंक करना ज़रूरी होता है ( दूसरे संसाधन (कॉल और प्रतिक्रिया के साथ) के साथ और शुल्क एपीआई से भी लिया जा सकता है). ऐसा करने के लिए, यह संसाधनों को यूनीक लेन-देन आईडी से जोड़ें सेक्शन.

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

उदाहरण के लिए, मान लें कि Reserve API कॉल और शुल्क एपीआई कॉल, यहां बताए गए तरीके से लिंक हैं: a Reserve API के रिस्पॉन्स हेडर में session_id नाम वाला फ़ील्ड Charge API से मिला reference_id नाम वाला रिस्पॉन्स हेडर. इस स्थिति में, आपके पास में यहां बताए गए तरीके से, लिंक संसाधनों के यूनीक लेन-देन आईडी सेक्शन में:

संसाधन जवाब देने की जगह मान
reserve/{id}**

हेडर

session_id
/charge/{id}**

हेडर

reference_id

रिफ़ंड कॉन्फ़िगर करना

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

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

रिफ़ंड कॉन्फ़िगर करने के लिए, रिफ़ंड एट्रिब्यूट का इस्तेमाल करें टॉगल को चालू करें और रिफ़ंड की जानकारी दें:

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

    txProviderStatus == 'OK'

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

एपीआई का इस्तेमाल करके, लेन-देन का रिकॉर्ड रखने से जुड़ी नीतियों को मैनेज करना

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

एपीआई का इस्तेमाल करके, लेन-देन का डेटा रिकॉर्ड करने से जुड़ी नीति बनाना

एपीआई प्रॉडक्ट के एट्रिब्यूट के तौर पर, ट्रांज़ैक्शन रिकॉर्ड करने की नीति तय की जाती है. इस कीवर्ड का मान विशेषता पहचानती है:

  • प्रॉडक्ट रिसॉर्स का यूआरआई सफ़िक्स जिसके लिए लेन-देन की रिकॉर्डिंग की नीति है अटैच किया गया है. प्रत्यय में एक पैटर्न वैरिएबल शामिल है, जो कर्ली ब्रैकेट में बंद होता है. पैटर्न रनटाइम के दौरान, एपीआई सेवाओं से वैरिएबल का आकलन किया जाता है. उदाहरण के लिए, नीचे दिया गया यूआरआई सफ़िक्स इसमें पैटर्न वैरिएबल {id} शामिल है.
    /reserve/{id}**
    

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

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

PUT अनुरोध जारी करके, किसी एपीआई प्रॉडक्ट में ट्रांज़ैक्शन रिकॉर्डिंग नीति से जुड़ा एट्रिब्यूट जोड़ा जाता है मैनेजमेंट एपीआई में https://api.enterprise.apigee.com/v1/organizations/{org_name}/apiproducts/{apiproduct_Id} अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है (न कि कमाई करने वाले एपीआई के लिए).

एपीआई का इस्तेमाल करके, यह तय करना कि लेन-देन पूरा हुआ या नहीं

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

एपीआई प्रॉडक्ट के एट्रिब्यूट के तौर पर, ट्रांज़ैक्शन पूरा होने की शर्तें बताई जाती हैं. इस तरीके से करें management API को एक PUT अनुरोध जारी किया जा रहा है https://api.enterprise.apigee.com/v1/organizations/{org_name}/apiproducts/{apiproduct_Id} अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है (न कि कमाई करने वाले एपीआई के लिए).

उदाहरण के लिए, नीचे दिए गए अनुरोध में, लेन-देन तब सफल होता है, जब txProviderStatus, success है (लेन-देन पूरा होने की शर्त से जुड़ा है खास जानकारी हाइलाइट की गई है).

$ curl -H "Content-Type: application/json" -X PUT -d \ 
'{
        "apiResources": [
        "/reserve/{id}**"       
        ],
        "approvalType": "auto",
        "attributes": [                         
        {
                "name": "MINT_TRANSACTION_SUCCESS_CRITERIA",
                "value": "txProviderStatus == 'OK'"
        }
        ],
        "description": "Payment",
        "displayName": "Payment",
        "environments": [
        "dev"
        ],
        "name": "payment",
        "proxies": [],
        "scopes": [
        ""
        ]
}' \
"https://api.enterprise.apigee.com/v1/organizations/{org_name}/apiproducts/payment" \
-u email:password

एपीआई का इस्तेमाल करके कस्टम एट्रिब्यूट तय करना

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

एपीआई प्रॉडक्ट के एट्रिब्यूट के तौर पर कस्टम एट्रिब्यूट तय किए जा सकते हैं. एक PUT जारी करके ऐसा करें मैनेजमेंट एपीआई से अनुरोध करने की सुविधा https://api.enterprise.apigee.com/v1/organizations/{org_name}/apiproducts/{apiproduct_Id} अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है (न कि कमाई करने वाले एपीआई के लिए).

किसी एपीआई प्रॉडक्ट में जोड़े जाने वाले हर कस्टम एट्रिब्यूट के लिए, आपको एक नाम और विशेषता मान सेट करें. नाम इस फ़ॉर्मैट में होना चाहिए: MINT_CUSTOM_ATTRIBUTE_{num}, जहां {num} एक पूर्णांक है.

उदाहरण के लिए, नीचे दिए गए अनुरोध में तीन कस्टम एट्रिब्यूट के बारे में बताया गया है.

$ curl -H "Content-Type: application/json" -X PUT -d \
'{
        "apiResources": [
        "/reserve/{id}**",
        "/charge/{id}**"
        ],
        "approvalType": "auto",
        "attributes": [
        {
                "name": "MINT_CUSTOM_ATTRIBUTE_1",
                "value": "test1"
        },
        {
                "name": "MINT_CUSTOM_ATTRIBUTE_2",
                "value": "test2"
        }
 
        ],
        "name": "payment",
        "proxies": [],
        "scopes": [
                ""
        ]
}' \
"https://api.enterprise.apigee.com/v1/organizations/{org_name}/apiproducts/payment" \
-u email:password

किसी लेन-देन में लेन-देन पूरा होने की शर्तें सेट करने के उदाहरण रिकॉर्डिंग की नीति

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

सक्सेस क्राइटेरिया एक्सप्रेशन मान्य एक्सप्रेशन क्या है? एपीआई प्रॉक्सी से txProviderStatus की वैल्यू आकलन का नतीजा
null सही "200" गलत
"" गलत "200" गलत
" " गलत "200" गलत
"sdfsdfsdf" गलत "200" गलत
"txProviderStatus =='100'" सही "200" गलत
"txProviderStatus =='200'" सही "200" सही
"true" सही "200" सही
"txProviderStatus=='OK' OR
txProviderStatus=='Not Found' OR
txProviderStatus=='Bad Request'"
सही "OK" सही
"txProviderStatus matches '(OK)|(Not Found)|(Bad Request)'" सही "OK" सही
"txProviderStatus matches '(OK)|(Not Found)|(Bad Request)'" सही "Not Found" सही
"txProviderStatus matches '(OK)|(Not Found)|(Bad Request)'" सही "Bad Request" सही
"(txProviderStatus?:'') matches '(?i)(OK)|(Not Found)|(Bad Request)'" सही "Bad Request" सही
"(txProviderStatus?:'') matches '(?i)(OK)|(Not Found)|(Bad Request)'" सही null गलत
"txProviderStatus matches '(?i)(OK)|(Not Found)|(Bad Request)'" सही "bad request" सही
"txProviderStatus matches '(?i)(OK)|(Not Found)|(Bad Request)'" सही "Redirect" गलत
"txProviderStatus matches '(?i)(OK)|(Not Found)|(Bad Request)'" सही "heeeelllooo" गलत
"txProviderStatus matches '(?i)(OK)|(Not Found)|(Bad Request)'" सही null गलत
"txProviderStatus == 100" सही "200" गलत