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

आपको 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