कमाई करने के लिए डेवलपर को माइग्रेट करना

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

अगर आपके पास ऐसे डेवलपर हैं जिन्हें आपको कमाई करने की सुविधा पर माइग्रेट करना है, तो:

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

    ध्यान दें: अगर डेवलपर से सेटअप करने का शुल्क पहले ही लिया जा चुका है, तो उसे वापस पाने के लिए, waivefees क्वेरी पैरामीटर को true पर सेट करें.

  6. अगर माइग्रेट किए जा रहे डेवलपर के पास मौजूदा लेन-देन हैं, तो लेन-देन के इस्तेमाल को मैन्युअल तरीके से ट्रांसफ़र किया जा सकता है. इसके लिए, इस संसाधन का इस्तेमाल करें:
    /organizations/{org_name}/transactions. यहां {org_name} संगठन का नाम है.

    ध्यान दें: अगर किसी डेवलपर के पास मौजूदा ट्रांज़ैक्शन नहीं हैं, तो इस चरण को छोड़ा जा सकता है.

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

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

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

    प्रॉपर्टी ब्यौरा डिफ़ॉल्ट ज़रूरी है?
    application

    डेवलपर ऐप्लिकेशन का आईडी.

    		 लागू नहीं हां
    batchSize

    आपको जितने लेन-देन ट्रांसफ़र करने हैं उनकी संख्या.

    		 1 नहीं
    custAttn

    कस्टम एट्रिब्यूट की वह वैल्यू जिसका इस्तेमाल batchSize के साथ किया जाता है, ताकि ट्रांज़ैक्शन के इस्तेमाल का हिसाब लगाया जा सके.

    संदेश में कस्टम एट्रिब्यूट की संख्या को पॉज़िटिव पूर्णांक या दशमलव (दशमलव के बाद चार अंकों तक) वैल्यू के तौर पर तय किया जाना चाहिए. नेगेटिव वैल्यू इस्तेमाल नहीं की जा सकतीं.

    कस्टम एट्रिब्यूट को इनमें तय किया जाना चाहिए:

    		 लागू नहीं हां
    product

    एपीआई प्रॉडक्ट का आईडी.

    		 लागू नहीं हां
    type

    इसे CHARGE पर सेट होना चाहिए. यह डिफ़ॉल्ट रूप से सेट होता है.

    		 CHARGE नहीं

    पुष्टि करने के चरणों को छोड़कर, लेन-देन की संख्या को ज़बरदस्ती सेट करने के लिए, force क्वेरी पैरामीटर को true पर सेट करें. उदाहरण के लिए, ?force=true. डिफ़ॉल्ट रूप से, ?force=false और पुष्टि करने के चरण पूरे किए जाते हैं. उदाहरण के लिए, अगर किसी प्रीपेड डेवलपर के खाते में कोई बैलेंस नहीं है और खाते पर गतिविधि निलंबित है, तो ?force=false अनुरोध की पुष्टि नहीं हो पाएगी.

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

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "application":{
     "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
   },
   "product":{
     "id":"testproduct"
   },
   "batchSize":50
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password

    यहां दिए गए अनुरोध में, तय किए गए ऐप्लिकेशन और एपीआई प्रॉडक्ट के लिए, लेन-देन के इस्तेमाल की सीमा 12.5 पर सेट की गई है. अनुरोध में, batchSize को 125 पर सेट किया जाता है. साथ ही, एपीआई प्रॉडक्ट के लिए तय किए गए पहले कस्टम एट्रिब्यूट की वैल्यू को 0.1 पर सेट किया जाता है. जब इन दोनों को आपस में गुणा किया जाता है, तो 125 * 0.1 = 12.5 होता है.

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "application":{
     "id":"6a9b1afc-2110-43d6-bae7-1b137aecb05b"
   },
   "product":{
     "id":"testproduct"
   },
   "batchSize": 125,
   "custAtt1" : 0.1
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password
  7. अगर किसी डेवलपर से सेटअप या बार-बार लगने वाले ज़रूरी शुल्क नहीं लिए गए हैं, तो मैन्युअल तरीके से रेट प्लान के लिए सेटअप या बार-बार लगने वाला शुल्क लिया जा सकता है. इसके लिए, यह संसाधन इस्तेमाल करें:
    /organizations/{org_name}/transactions, जहां {org_name} संगठन का नाम है.

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

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

    प्रॉपर्टी ब्यौरा डिफ़ॉल्ट ज़रूरी है?
    currency

    किराया प्लान के लिए इस्तेमाल की गई मुद्रा. मुद्रा के लिए ISO 4217 कोड डालें. जैसे, अमेरिकी डॉलर के लिए usd या स्विस फ़्रैंक के लिए chf.

    		 लागू नहीं हां
    developer

    डेवलपर का आईडी.

    		 लागू नहीं हां
    rate

    सेटअप या बार-बार लगने वाला शुल्क.

    		 लागू नहीं हां
    ratePlan

    किराया प्लान का आईडी.

    		 लागू नहीं हां
    type

    SETUPFEES या RECURRINGFEES पर सेट करें.

    		 CHARGE हां

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

    उदाहरण के लिए, यहां दिए गए अनुरोध में, रेट प्लान के लिए रजिस्टर किए गए डेवलपर से सेटअप करने के लिए 10 डॉलर का शुल्क लिया जाता है:

    $ curl -H "Content-Type:application/json" -X POST -d \
'{ 
   "developer":{
     "id":"dev1@myorg.com"
   },
   "currency":{
     "id":"usd"
   },
   "ratePlan":{
     "id":"mypackage_rateplan1"
   },   
   "rate":10,
   "type":"SETUPFEES"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myOrg/transactions" \
-u email:password