আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।
প্রিপেইড অ্যাকাউন্টের ব্যালেন্স পরিচালনা করতে, আপনি নিম্নলিখিত কাজগুলো করতে পারেন:
- আপনার প্রিপেইড অ্যাকাউন্টের বর্তমান ব্যালেন্স দেখুন। এপিআই (API) ব্যবহার করে প্রিপেইড অ্যাকাউন্টের ব্যালেন্স দেখার পদ্ধতি দেখুন।
- ওয়ার্ল্ডপে-এর মতো কোনো তৃতীয় পক্ষের পেমেন্ট প্রোভাইডার ব্যবহার করে প্রয়োজন অনুযায়ী অ্যাকাউন্ট ব্যালেন্স রিচার্জ (টাকা যোগ) করুন। তৃতীয় পক্ষের পেমেন্ট প্রোভাইডার ব্যবহার করে প্রিপেইড ব্যালেন্স পরিচালনা দেখুন।
বিকল্পভাবে, আপনি ম্যানুয়ালি অথবা একটি ইন্টিগ্রেটেড বিলিং সিস্টেমের মাধ্যমে পেমেন্ট ট্র্যাক করে এবং তারপর অ্যাকাউন্ট রিচার্জ করার জন্য মনিটাইজেশন এপিআই কল করে রিচার্জটি পরিচালনা করতে পারেন, যেমনটি "ম্যানুয়ালি প্রিপেইড ব্যালেন্স পরিচালনা" অংশে বর্ণনা করা হয়েছে।
- মনিটাইজেশন এপিআই এবং ওয়ার্ল্ডপে-এর মতো কোনো থার্ড-পার্টি পেমেন্ট প্রোভাইডার ব্যবহার করে, প্রিপেইড অ্যাকাউন্টের ব্যালেন্স একটি নির্দিষ্ট সীমার নিচে নেমে গেলে স্বয়ংক্রিয়ভাবে রিলোডের ব্যবস্থা করুন। রেট প্ল্যানের জন্য পুনরাবৃত্ত পেমেন্ট পরিচালনা করতে এই বিকল্পটি কার্যকর। এ বিষয়ে তথ্যের জন্য, এপিআই ব্যবহার করে প্রিপেইড অ্যাকাউন্টের ব্যালেন্স স্বয়ংক্রিয়ভাবে রিলোড করার ব্যবস্থা দেখুন।
আমি কীভাবে প্রিপেইড অ্যাকাউন্টের অবশিষ্ট ব্যালেন্স গণনা করব?
পরবর্তী বিভাগগুলিতে বর্ণিত পদ্ধতি অনুযায়ী, কোনো ডেভেলপার বা কোম্পানির প্রিপেইড অ্যাকাউন্টের ব্যালেন্স দেখার সময়, আপনাকে রেসপন্স থেকে নিম্নলিখিত মানগুলি সংগ্রহ করতে হবে:
-
amount: চলতি বিলিং মেয়াদের জন্য উপলব্ধ মোট টাকার পরিমাণ। এই বিভাগে বর্ণিত পদ্ধতিগুলি ব্যবহার করে আপনি যখন প্রিপেইড অ্যাকাউন্ট রিচার্জ করেন, তখন এই মানটি আপডেট করা হয়। -
usage: চলতি বিলিং সময়কালে ব্যবহৃত মোট অর্থের পরিমাণ। প্রতিটি যোগ্য নগদীকৃত লেনদেনের মাধ্যমে অথবা একটি ক্রেডিট (ধনাত্মক বা ঋণাত্মক) ইস্যু করার মাধ্যমে এই মানটি আপডেট করা হয়।
amount পরিমাণ থেকে usage পরিমাণ বিয়োগ করে আপনি চলতি বিলিং সময়ের অবশিষ্ট প্রিপেইড অ্যাকাউন্ট ব্যালেন্স গণনা করতে পারেন। উদাহরণস্বরূপ, যদি amount পরিমাণ ৩৩৫.৫০ এবং usage পরিমাণ ৩৪ হয়, তাহলে অবশিষ্ট ব্যালেন্স নিম্নরূপভাবে গণনা করা হবে:
amount(335.50) - usage(34) = 229.50এপিআই ব্যবহার করে প্রিপেইড অ্যাকাউন্টের ব্যালেন্স দেখা
নিম্নলিখিত বিভাগগুলিতে বর্ণনা করা হয়েছে কীভাবে এপিআই ব্যবহার করে কোনো ডেভেলপার বা কোম্পানির প্রিপেইড অ্যাকাউন্টের ব্যালেন্স দেখা যায়।
একজন ডেভেলপারের জন্য প্রিপেইড অ্যাকাউন্টের ব্যালেন্স দেখা
কোনো ডেভেলপারের প্রিপেইড অ্যাকাউন্টের ব্যালেন্স দেখতে, নিম্নলিখিত API-গুলোর যেকোনো একটিতে একটি GET রিকোয়েস্ট পাঠান, যেখানে {developer_id} হলো সেই ডেভেলপারের ইমেল অ্যাড্রেস:
-
/mint/organizations/{org_name}/developers/{developer_id}/developer-balances: একজন ডেভেলপারের প্রিপেইড অ্যাকাউন্টের ব্যালেন্স এবং পুনরাবৃত্ত সেটআপের তথ্য প্রদান করে। -
/mint/organizations/{org_name}/developers/{developer_id}/prepaid-developer-balances: প্রিপেইড অ্যাকাউন্টের ব্যালেন্সের তথ্য প্রদান করে, যার মধ্যে বর্তমান ও মোট ব্যালেন্স, ব্যবহার, টপ-আপ এবং ব্যবহার কর অন্তর্ভুক্ত।
ফলাফল ফিল্টার করার জন্য আপনি নিম্নলিখিত কোয়েরি প্যারামিটারগুলো ব্যবহার করতে পারেন:
| কোয়েরি প্যারামিটার | বর্ণনা |
|---|---|
all | সমস্ত এপিআই প্যাকেজ ফেরত দেওয়া হবে কিনা তা নির্দিষ্ট করার ফ্ল্যাগ। যদি এটি false- এ সেট করা হয়, তাহলে প্রতি পৃষ্ঠায় ফেরত আসা এপিআই প্যাকেজের সংখ্যা size কোয়েরি প্যারামিটার দ্বারা নির্ধারিত হয়। ডিফল্ট মান false । |
size | প্রতি পৃষ্ঠায় ফেরত আসা এপিআই প্যাকেজের সংখ্যা। ডিফল্ট মান ২০। যদি ' all ' কোয়েরি প্যারামিটারটি ' true সেট করা থাকে, তাহলে এই প্যারামিটারটি উপেক্ষা করা হয়। |
page | আপনি যে পৃষ্ঠাটি ফেরত পেতে চান তার নম্বর (যদি বিষয়বস্তু পৃষ্ঠাঙ্কিত হয়)। যদি ' all ' কোয়েরি প্যারামিটারটি ' true সেট করা থাকে, তাহলে এই প্যারামিটারটি উপেক্ষা করা হয়। |
currencyId | যে মুদ্রার প্রিপেইড অ্যাকাউন্টের ব্যালেন্স দেখতে চান, সেই মুদ্রার আইডি। |
উদাহরণস্বরূপ:
$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/developers/{developer_id}/developer-balances" \
-u email:password
নিম্নলিখিতটি প্রতিক্রিয়ার একটি উদাহরণ:
{ "developerBalance": [ { "amount": 2005, "chargePerUsage": false, "id": "your-provider-id", "isRecurring": false, "supportedCurrency": { "description": "United States Dollars", "displayName": "United States Dollars", "id": "usd", "name": "USD", "organization": { "address": [ { "address1": "10 Almaden Blvd.", "city": "San Jose", "country": "US", "id": "32e808d8-3a3c-4d76-a0ae-17d70a982c61", "isPrimary": true, "state": "CA", "zip": "95113" } ], "approveTrusted": false, "approveUntrusted": false, "billingCycle": "CALENDAR_MONTH", "country": "US", "currency": "USD", "description": "my-org", "groupOrganization": false, "hasBillingAdjustment": false, "hasBroker": false, "hasSelfBilling": false, "hasSeparateInvoiceForProduct": false, "id": "my-org", "issueNettingStmt": false, "name": "my-org", "nettingStmtPerCurrency": false, "selfBillingAsExchOrg": false, "selfBillingForAllDev": false, "separateInvoiceForFees": false, "status": "ACTIVE", "supportedBillingType": "BOTH", "taxModel": "HYBRID", "timezone": "UTC" }, "status": "ACTIVE", "virtualCurrency": false }, "usage": 2.1572 } ], "totalRecords": 1 }
একটি কোম্পানির প্রিপেইড অ্যাকাউন্টের ব্যালেন্স দেখা
কোনো কোম্পানির প্রিপেইড অ্যাকাউন্টের ব্যালেন্স দেখতে, /mint/organizations/{org_name}/companies/{company_id}/developer-balances -এ একটি GET রিকোয়েস্ট পাঠান, যেখানে {company_id} হলো কোম্পানির আইডি। কোম্পানিটি প্রিপেইড হলে, রিকোয়েস্টটি বর্তমান প্রিপেইড অ্যাকাউন্টের ব্যালেন্স দেখাবে। আর কোম্পানিটি পোস্টপেইড হলে, রিকোয়েস্টটি বর্তমান ক্রেডিট লিমিট দেখাবে।
ফলাফল ফিল্টার করার জন্য আপনি নিম্নলিখিত কোয়েরি প্যারামিটারগুলো ব্যবহার করতে পারেন:
| কোয়েরি প্যারামিটার | বর্ণনা |
|---|---|
all | সমস্ত এপিআই প্যাকেজ ফেরত দেওয়া হবে কিনা তা নির্দিষ্ট করার ফ্ল্যাগ। যদি এটি false- এ সেট করা হয়, তাহলে প্রতি পৃষ্ঠায় ফেরত আসা এপিআই প্যাকেজের সংখ্যা size কোয়েরি প্যারামিটার দ্বারা নির্ধারিত হয়। ডিফল্ট মান false । |
size | প্রতি পৃষ্ঠায় ফেরত আসা এপিআই প্যাকেজের সংখ্যা। ডিফল্ট মান ২০। যদি ' all ' কোয়েরি প্যারামিটারটি ' true সেট করা থাকে, তাহলে এই প্যারামিটারটি উপেক্ষা করা হয়। |
page | আপনি যে পৃষ্ঠাটি ফেরত পেতে চান তার নম্বর (যদি বিষয়বস্তু পৃষ্ঠাঙ্কিত হয়)। যদি ' all ' কোয়েরি প্যারামিটারটি ' true সেট করা থাকে, তাহলে এই প্যারামিটারটি উপেক্ষা করা হয়। |
currencyId | যে মুদ্রার প্রিপেইড অ্যাকাউন্টের ব্যালেন্স দেখতে চান, সেই মুদ্রার আইডি। |
উদাহরণস্বরূপ:
$ curl -H "Accept:application/json" -X GET \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/companies/{company_id}/developer-balances" \
-u email:password
কোনো ডেভেলপারের প্রিপেইড অ্যাকাউন্টের ব্যালেন্স দেখার ক্ষেত্রে, প্রতিক্রিয়াটি উপরে দেখানো প্রতিক্রিয়ার অনুরূপ।