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

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

    लेन-देन के इस्तेमाल का हिसाब लगाने के लिए, quantitySize के साथ इस्तेमाल किए जाने वाले कस्टम एट्रिब्यूट की वैल्यू.

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

    कस्टम एट्रिब्यूट की वैल्यू इनमें होनी चाहिए:

    लागू नहीं हां
    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