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

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

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

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

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

একটি রেট প্ল্যান কেনার সময় সেটআপ ফি মওকুফ করতে, waivefees ক্যোয়ারী প্যারামিটারটিকে true সেট করুন৷ আপনি যখন ডেভেলপারদেরকে নগদীকরণে স্থানান্তরিত করেন তখন এই পতাকাটি উপযোগী হয়, যেমনটি ডেভেলপারদেরকে নগদীকরণে স্থানান্তরিত করাতে বর্ণিত হয়েছে।

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

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

রেট প্ল্যান শুরু হওয়ার তারিখ। উদাহরণস্বরূপ: 2017-03-24

N/A হ্যাঁ
endDate

রেট প্ল্যান শেষ হওয়ার তারিখ। উদাহরণস্বরূপ: 2017-09-24

রেট প্ল্যানটি নির্দিষ্ট তারিখে দিনের শেষ না হওয়া পর্যন্ত কার্যকর থাকবে। আপনি যদি 1 ডিসেম্বর, 2017-এ একটি রেট প্ল্যানের মেয়াদ শেষ করতে চান, উদাহরণস্বরূপ, আপনার শেষ তারিখের মান 2017-11-30 এ সেট করা উচিত। এই ক্ষেত্রে, রেট প্ল্যানটি 30 নভেম্বর, 2017 তারিখে দিনের শেষে শেষ হবে; ডিসেম্বর 1, 2017-এ সমস্ত অনুরোধ ব্লক করা হবে।

N/A না
developer

id প্রপার্টি যা রেট প্ল্যান ক্রয়কারী ডেভেলপার বা কোম্পানির আইডি নির্ধারণ করে।

N/A হ্যাঁ
quotaTarget

অ্যাপ ডেভেলপারের জন্য অনুমোদিত লেনদেনের লক্ষ্য সংখ্যা। লক্ষ্য সংখ্যার কত শতাংশে পৌঁছেছে, যেমন 90%, 100%, বা 150% এর উপর ভিত্তি করে বিজ্ঞপ্তিগুলি পাঠানো হয় কিনা এবং কখন আপনি কনফিগার করতে পারেন। লক্ষ্য সংখ্যা পৌঁছানোর পরে অতিরিক্ত লেনদেন ব্লক করা হয় না.

এই মানটিকে একটি ধনাত্মক পূর্ণসংখ্যার মান সেট করুন বা একটি অ্যাপ বিকাশকারীর জন্য বিজ্ঞপ্তিগুলি অক্ষম করতে 0 করুন৷

0 না
ratePlan

id সম্পত্তি যা হার পরিকল্পনার আইডি সংজ্ঞায়িত করে।

রেট প্ল্যান আইডি ডিসপ্লে নামের থেকে আলাদা। আইডি সহ রেট প্ল্যানের বিশদ দেখতে, রেট প্ল্যান পৃষ্ঠাটি দেখুন।

N/A হ্যাঁ
suppressWarning

ফ্ল্যাগ যা নির্দিষ্ট করে যে ত্রুটিটি দমন করতে হবে কিনা যদি বিকাশকারী একটি রেট প্ল্যান কেনার চেষ্টা করে যা অন্য ক্রয়কৃত রেট প্ল্যানকে ওভারল্যাপ করে। মান নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

  • true - নগদীকরণ সমস্ত ক্রয়কৃত রেট প্ল্যানগুলি বন্ধ করে দেয় যা বিকাশকারীর API প্যাকেজগুলিতে থাকে যেগুলিতে বিরোধপূর্ণ API পণ্য রয়েছে৷ এটি তখন বিকাশকারীর জন্য একটি নতুন API প্যাকেজ ক্রয় করে।
  • false - একটি ওভারল্যাপিং রেট প্ল্যান থাকা অবস্থায় একটি ত্রুটি নিক্ষেপ করা হয়৷
N/A না
waveTerminationCharge

নতুন রেট প্ল্যান সক্রিয় করার অংশ হিসাবে একটি সক্রিয় রেট প্ল্যান বন্ধ করা হলে সমাপ্তি ফি মওকুফ করা হবে কিনা তা নির্দিষ্ট করে। মান নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

  • true - নতুন রেট প্ল্যান সক্রিয় করার অংশ হিসাবে একটি সক্রিয় রেট প্ল্যান বন্ধ হয়ে গেলে সমাপ্তি ফি মওকুফ করুন৷
  • false - নতুন রেট প্ল্যান সক্রিয় করার অংশ হিসাবে একটি সক্রিয় রেট প্ল্যান বন্ধ হয়ে গেলে সমাপ্তি ফি মওকুফ করবেন না।
N/A না

উদাহরণ স্বরূপ, নিম্নোক্ত অনুরোধটি নির্দিষ্ট ডেভেলপারের জন্য 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 প্যাকেজ ক্রয় করে।

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

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 প্রপার্টি উল্লেখ করুন। /organizations/{org_name}/developers/{developer_or_company_id}/developer-rateplans/{developer_rateplan_id} সম্পদ।

রেট প্ল্যানটি নির্দিষ্ট শেষ তারিখে দিন শেষ না হওয়া পর্যন্ত কার্যকর থাকবে। আপনি যদি 1 ডিসেম্বর, 2017-এ একটি রেট প্ল্যানের মেয়াদ শেষ করতে চান, উদাহরণস্বরূপ, আপনার শেষ তারিখের মান 2017-11-30 এ সেট করা উচিত। এই ক্ষেত্রে, রেট প্ল্যানটি 30 নভেম্বর, 2017 তারিখে দিনের শেষে শেষ হবে; ডিসেম্বর 1, 2017-এ সমস্ত অনুরোধ ব্লক করা হবে।

আপনি যখন প্রকাশিত রেট প্ল্যান ক্রয় করেন তখন প্রতিক্রিয়াতে {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 , যেখানে {developer_id} ইমেল হল একটি GET অনুরোধ জারি করে আপনি বিকাশকারী রেট প্ল্যানের জন্য {developer-rateplan-id} পেতে পারেন বিকাশকারীর ঠিকানা। আরও তথ্যের জন্য, একজন ডেভেলপার দ্বারা কেনা সমস্ত রেট প্ল্যান দেখা দেখুন।

নিম্নলিখিত অনুরোধটি শেষ তারিখটি ডিসেম্বর 1, 2017-এ আপডেট করে৷ অর্থাৎ, রেট প্ল্যানটি 30 নভেম্বর, 2017 তারিখে দিনের শেষে শেষ হবে; ডিসেম্বর 1, 2017-এ সমস্ত অনুরোধ ব্লক করা হবে।

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
  }'