API ব্যবহার করে রেট প্ল্যান কেনা

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

এই বিভাগে, কীভাবে প্রকাশিত রেট প্ল্যান কিনতে হয় এবং API ব্যবহার করে কেনা রেট প্ল্যানের মেয়াদ শেষ করতে বা বাতিল করতে হয় তা বর্ণনা করা হয়েছে।

API ব্যবহার করে প্রকাশিত রেট প্ল্যান কেনা

কোনও রেট প্ল্যান প্রকাশ করার পরে, কোনও ডেভেলপার বা কোম্পানি /mint/organizations/{org_name}/developers/{developer_or_company_id}/developer-rateplans-এ POST অনুরোধ ইস্যু করে এটি কিনতে (বা "গ্রহণ করতে") পারে, যেখানে {org_name} হল সংস্থার নাম এবং {developer_or_company_id} হল ডেভেলপার বা কোম্পানির আইডি।

রেট প্ল্যান কেনার সময় সেট-আপ ফি মকুব করতে, waivefees কোয়েরি প্যারামিটার true হিসেবে সেট করুন। আপনি যখন মনিটাইজেশনের জন্য ডেভেলপারদের মাইগ্রেট করছেন, তখন এই ফ্ল্যাগটি কাজে লাগে, যেমন মনিটাইজেশনের জন্য ডেভেলপারদের মাইগ্রেট করা নিবন্ধে বর্ণনা করা হয়েছে।

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

যেমন, নিম্নলিখিত অনুরোধটি নির্দিষ্ট ডেভেলপারদের জন্য location_&_messaging রেট প্ল্যান কেনাকাটা করে:

curl "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/5cTWgdUvdr6JW3xU/developer-rateplans" \
  -X POST \
  -H "Content-Type:application/json" \
  -u email:password \
  -d '{
   "developer":{
     "id":"5cTWgdUvdr6JW3xU"
   },
   "startDate":"2017-08-30",
   "ratePlan":{
     "id":"location_&_messaging"
   },
   "suppressWarning":false
  }'

এই উদাহরণে, suppressWarning প্রপার্টি false-এ সেট করা আছে। এই ক্ষেত্রে, কোনও বিরোধ হলে একটি সমস্যা দেখানো হবে। যেমন, ডেভেলপার যদি এমন কোনও রেট প্ল্যান কেনার চেষ্টা করেন যা আগে কেনা অন্য রেট প্ল্যানের সাথে ওভারল্যাপ করে, তাহলে একটি সমস্যা দেখানো হয়। এটি এমন একটি অ্যাপ্লিকেশন চালু করে যা মনিটাইজেশনের জন্য একটি ইউজার ইন্টারফেস প্রদান করে যাতে সমস্যাটি ইন্টারসেপ্ট করা যায় এবং কনফার্মেশনের জন্য (যেমন উপযুক্ত) ডেভেলপারকে কনফ্লিক্ট করা প্রোডাক্ট দেখানো যায়। suppressWarning true-এ সেট করা থাকলে, মনিটাইজেশন কেনা সব রেট প্ল্যান বাতিল করে দেয়। ডেভেলপারকে API প্যাকেজ থেকে সেইসব কনফ্লিক্ট করা প্রোডাক্ট সরিয়ে দিতে হয়। এটি তারপরে ডেভেলপারের জন্য একটি নতুন API প্যাকেজ কেনে।

নিম্নলিখিত অনুরোধটি একটি অ্যাডজাস্ট করা যায় এমন বিজ্ঞপ্তি রেট প্ল্যান কেনে এবং ট্রানজ্যাকশনের টার্গেট সংখ্যা ৪০০০ হিসেবে সেট করে।

curl "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/5cTWgdUvdr6JW3xU/developer-rateplans" \
  -X POST \
  -H "Content-Type:application/json" \
  -u email:password \
  -d '{
   "developer":{
     "id":"5cTWgdUvdr6JW3xU"
   },
   "ratePlan":{
     "id":"adjustable-notification-plan"
   },
   "startDate": "2017-03-24",
   "quotaTarget": 4000,
   "suppressWarning":false
  }'

উপরের উদাহরণগুলির মধ্যে যেকোনও একটিতে, নিম্নলিখিত সমস্যার মেসেজটি দেখানো হলে:

Developer legal name not specified. 

তারপরে আপনাকে অবশ্যই মনিটাইজেশন অ্যাট্রিবিউট MINT_DEVELOPER_ADDRESS এবং MINT_DEVELOPER_LEGAL_NAME সেট করতে হবে এবং তারপরে API কলটি আবার করতে হবে।

API ব্যবহার করে ডেভেলপারের কেনা রেট প্ল্যানের মেয়াদ শেষ করা

ডেভেলপারের কেনা রেট প্ল্যানের মেয়াদ শেষ করতে (বা বাতিল করতে), কেনা রেট প্ল্যানের বিবরণ আপডেট করুন এবং /organizations/{org_name}/developers/{developer_or_company_id}/developer-rateplans/{developer_rateplan_id} রিসোর্সে PUT অনুরোধে অনুরোধের বডিতে endDate প্রপার্টি নির্দিষ্ট করুন।

উল্লেখ করা শেষ তারিখের দিন শেষ না হওয়া পর্যন্ত রেট প্ল্যান কার্যকর থাকবে। আপনি যদি ১ ডিসেম্বর, ২০১৭-এ কোনও রেট প্ল্যানের মেয়াদ শেষ করতে চান, তাহলে আপনাকে endDate ভ্যালু ২০১৭-১১-৩০ হিসেবে সেট করতে হবে। এই ক্ষেত্রে, ৩০ নভেম্বর, ২০১৭ তারিখে দিনের শেষে রেট প্ল্যানের মেয়াদ শেষ হয়ে যাবে; ১ ডিসেম্বর, ২০১৭ তারিখে করা সব অনুরোধ ব্লক করা হবে।

প্রকাশিত রেট প্ল্যান কিনলে, উত্তরে {developer_rateplan_id} দেখানো হয়।

যেমন:

{
  "created": "2017-03-31 18:59:54",
  "developer": {
    ...
  },
  "id": "b1c600b8-f871-496d-8173-12b9950d6ab1",
  "quotaTarget": 3000,
  "ratePlan": {
    ...
  },
  "startDate": "2017-03-31 00:00:00",
  "updated": "2017-03-31 18:59:54",
  "waiveTerminationCharge": false
}

অথবা, আপনি /organizations/{org_name}/developers/{developer_id}/developer-accepted-rateplans-এ একটি GET অনুরোধ করে ডেভেলপারের রেট প্ল্যানের {developer-rateplan-id} পেতে পারেন, যেখানে {developer_id} হল ডেভেলপারের ইমেল আইডি। আরও তথ্যের জন্য, কোনও ডেভেলপারের কেনা সব রেট প্ল্যান দেখা নিবন্ধটি দেখুন।

নিম্নলিখিত অনুরোধটি শেষ হওয়ার তারিখ ১ ডিসেম্বর, ২০১৭ হিসেবে আপডেট করে। অর্থাৎ, ৩০ নভেম্বর, ২০১৭-এর শেষে রেট প্ল্যানের মেয়াদ শেষ হয়ে যাবে; ১ ডিসেম্বর, ২০১৭-এর সব অনুরোধ ব্লক করা হবে।

curl "https://api.enterprise.apigee.com/v1/mint/organizations/myorg/developers/dev@mycompany.com/developer-rateplans/b1c600b8-f871-496d-8173-12b9950d6ab1"
  -X PUT \
  -H "Content-Type:application/json" \
  -u email:password \
  -d '{
   "id" : "b1c600b8-f871-496d-8173-12b9950d6ab1",
   "developer":{
     "id":"dev@mycompany.com"
   },
   "ratePlan":{
     "id":"p1_adjustable-notification-plan"
   },
   "startDate": "2017-04-15 00:00:00",
   "endDate": "2017-11-30",
   "quotaTarget": 3000,
   "suppressWarning":false
  }'