মনিটাইজেশনের জন্য ডেভেলপারদের মাইগ্রেট করা

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন।
তথ্য

আপনার কাছে আগে থেকেই এমন ডেভেলপার থাকলে যাদের মনিটাইজেশনে মাইগ্রেট করতে হবে:

  1. আপনি যেসব ডেভেলপারদের মাইগ্রেট করছেন তাদের জন্য API প্রোডাক্ট, API প্যাকেজ ও রেট প্ল্যান তৈরি করুন, যদি সেগুলি আগে থেকে না থাকে। আরও তথ্যের জন্য, এখানে দেখুন:
  2. রেট প্ল্যান প্রকাশ করা নিবন্ধে যেভাবে বর্ণনা করা হয়েছে সেইভাবে রেট প্ল্যান প্রকাশ করুন।
  3. অ্যাপ ডেভেলপার রেজিস্টার করুন নিবন্ধে যেভাবে বলা হয়েছে, সেইভাবে আপনার প্রতিষ্ঠানে নতুন ডেভেলপারদের যোগ করুন।
  4. প্রিপেড অ্যাকাউন্ট ব্যালেন্স ম্যানেজ করুন নিবন্ধে বর্ণিত পদ্ধতি অনুযায়ী, প্রতিটি ডেভেলপারের জন্য প্রিপেড ব্যালেন্স টপ-আপ করুন।
  5. API ব্যবহার করে রেট প্ল্যান কেনা নিবন্ধে বর্ণিত রেট প্ল্যানে সম্মতি জানান।

    মনে রাখবেন: সেট-আপ ফি মকুব করতে, কোনও ডেভেলপারকে আগেই চার্জ করা হলে, waivefees কোয়েরি প্যারামিটারকে true হিসেবে সেট করুন।

  6. আপনি যে ডেভেলপারকে মাইগ্রেট করছেন তার আগে থেকেই ট্রানজ্যাকশন থাকলে, আপনি নিম্নলিখিত রিসোর্স ব্যবহার করে ম্যানুয়ালি ট্রানজ্যাকশন ব্যবহার ট্রান্সফার করতে পারবেন:
    /organizations/{org_name}/transactions, যেখানে {org_name} হল সংস্থাটির নাম।

    মনে রাখবেন: কোনও ডেভেলপারের যদি আগে থেকে কোনও ট্রানজ্যাকশন না থাকে, তাহলে আপনি এই ধাপটি এড়িয়ে যেতে পারবেন।

    transactions রিসোর্স একটি ট্রানজ্যাকশন ইনসার্ট করে যা বর্তমান ট্রানজ্যাকশন ব্যবহারকে প্রতিফলিত করে এবং এই নতুন ভ্যালু প্রতিফলিত করতে সব ইন্টার্নাল কাউন্টার আপডেট করে।

    যেমন, মাইগ্রেশনের আগে ডেভেলপার যদি API-তে ১০০০টি কল ইস্যু করে থাকেন, তাহলে বর্তমান অ্যাক্টিভিটি ক্যাপচার করতে, আপনি transactions রিসোর্স কল করে এবং অনুরোধের বডিতে batchSize প্রপার্টি ১০০০ হিসেবে সেট করে ট্রানজ্যাকশন ব্যবহার ১০০০ হিসেবে সেট করতে পারেন।

    নিচের সারণীতে কনফিগারেশন প্রপার্টির সংক্ষিপ্তসার দেওয়া হল যা আপনি ট্রানজ্যাকশনের সংখ্যা, তাদের ডিফল্ট ভ্যালু এবং সেগুলি প্রয়োজনীয় কিনা তা ম্যানুয়ালি সেট করতে অনুরোধের বডিতে উল্লেখ করতে পারেন।

    প্রপার্টি বিবরণ ডিফল্ট প্রয়োজনীয়?
    application

    ডেভেলপার অ্যাপের আইডি।

    প্রযোজ্য নয় হ্যাঁ
    batchSize

    আপনি যতগুলি ট্রানজ্যাকশন ট্রান্সফার করতে চান।

    1 না
    custAttn

    batchSize-এর সাথে ব্যবহার করা কাস্টম অ্যাট্রিবিউটের ভ্যালু যা ট্রানজ্যাকশন ব্যবহার গণনা করতে ব্যবহার করা হয়।

    মেসেজে কাস্টম অ্যাট্রিবিউট নম্বরকে অবশ্যই ধনাত্মক পূর্ণ বা দশমিক (সর্বাধিক চারটি দশমিক স্থান) মান হিসেবে উল্লেখ করতে হবে। নেগেটিভ ভ্যালু ব্যবহার করা যাবে না।

    কাস্টম অ্যাট্রিবিউট এখানে অবশ্যই উল্লেখ করতে হবে:

    প্রযোজ্য নয় হ্যাঁ
    product

    API প্রোডাক্টের আইডি।

    প্রযোজ্য নয় হ্যাঁ
    type

    CHARGE হিসেবে সেট করা থাকতে হবে (এটি হল ডিফল্ট)।

    CHARGE না

    যাচাইকরণের ধাপগুলি এড়িয়ে যেতে এবং জোর করে ট্রানজ্যাকশনের সংখ্যা সেট করতে, force কোয়েরি প্যারামিটারকে true হিসেবে সেট করুন (যেমন, ?force=true)। ডিফল্ট হিসেবে, ?force=false এবং যাচাইকরণের ধাপগুলি এক্সিকিউট করা হয়। যেমন, কোনও প্রিপেড ডেভেলপারের অ্যাকাউন্টে ব্যালেন্স শূন্য এবং অ্যাক্টিভিটি সাসপেন্ড করা থাকলে, ?force=false যাচাইকরণের সময় অনুরোধটি ব্যর্থ হবে।

    যেমন, নিম্নলিখিত অনুরোধটি নির্দিষ্ট করা অ্যাপ্লিকেশন এবং API প্রোডাক্টের জন্য ট্রানজ্যাকশনের সংখ্যা ৫০ হিসেবে সেট করে:

    $ 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
    

    নিম্নলিখিত অনুরোধটি নির্দিষ্ট অ্যাপ্লিকেশন এবং API প্রোডাক্টের জন্য ট্রানজ্যাকশন ব্যবহার ১২.৫ হিসেবে সেট করে। অনুরোধে, batchSize-এর মান 125 হিসেবে সেট করা আছে এবং API প্রোডাক্টের জন্য সংজ্ঞায়িত প্রথম কাস্টম অ্যাট্রিবিউটের ভ্যালু 0.1 হিসেবে সেট করা আছে। যখন একসাথে গুণ করা হয়, ১২৫ * ০.১ হল ১২.৫।

    $ 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 যাচাইকরণের সময় অনুরোধটি ব্যর্থ হয়।

    যেমন, নিম্নলিখিত অনুরোধে রেট প্ল্যানে সাবস্ক্রাইব করা ডেভেলপারের জন্য মার্কিন ডলারে ১০ সেট-আপ ফি চার্জ করা হয়:

    $ 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