একটি সংরক্ষিত মূল্য পরিকল্পনা পড়ুন
উপলব্ধ ফোন নম্বর ব্রাউজ করার পরে আপনার API অ্যাকাউন্টের জন্য সংরক্ষিত মূল্যের সারিগুলি খুঁজে দেখুন। মূল্য বিকল্পের uuid ব্যবহার করুন, যা নির্বাচিত নম্বরের price তালিকায় থাকে; তার নম্বর, প্রিফিক্স ID বা এরিয়া ID ব্যবহার করবেন না। নির্বাচিত নম্বর এবং মূল্য বিকল্প একসাথে রাখুন।
এটি সংরক্ষিত মূল্যের একটি সামঞ্জস্য (compatibility) লুকআপ। এটি উপলব্ধতা বা মূল্য রিফ্রেশ করে না, কোনো নম্বর রিজার্ভ করে না, অর্ডার দেয় না, বা ভবিষ্যৎ কেনাকাটার পরিমাণের নিশ্চয়তা দেয় না। অর্ডার করার আগে একটি নতুন নম্বর অনুসন্ধানের সাথে ফেরত আসা মূল্য বিকল্পটি পর্যালোচনা করুন।
অনুরোধ
একটি অনুমোদিত IP ঠিকানা থেকে HTTPS-এর মাধ্যমে আপনার সক্রিয় API অ্যাকাউন্ট ব্যবহার করুন। PRICE_ID এর মান আপনার প্রাপ্ত সঠিক মূল্য বিকল্প ID-তে সেট করুন। এই মেথডটি একটি পাথ আর্গুমেন্ট পড়ে এবং কোনো বডি, তারিখ বা পেজিনেশন প্যারামিটার পড়ে না।
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"যে অ্যাকাউন্ট মূল্য বিকল্পটি পেয়েছিল, সেই একই অ্যাকাউন্টকেই এই লুকআপ করতে হবে। নিজে কোনো ID তৈরি করবেন না, ডেটাবেস সারির নম্বর ব্যবহার করবেন না, বা অন্য অ্যাকাউন্টের নির্বাচন প্রতিস্থাপন করবেন না। লিগ্যাসি মেথডটি শুধুমাত্র দৃশ্যমান মূল্য ID-এর সাথে মেলায়।
প্রতিক্রিয়া
নিচের কাল্পনিক উদাহরণটি শুধুমাত্র নির্বাচিত গ্রাহক-মুখী ফিল্ডগুলি দেখায়। প্রকৃত প্রতিক্রিয়াগুলি সম্পূর্ণ সংরক্ষিত সারি ফেরত দেয় এবং এতে অতিরিক্ত অ্যাকাউন্ট, সরবরাহকারী ও অভ্যন্তরীণ মূল্য মেটাডেটা থাকতে পারে। সম্পূর্ণ প্রতিক্রিয়াটি আপনার সার্ভারে রাখুন এবং শুধুমাত্র আপনার অ্যাপ্লিকেশনের প্রয়োজনীয় গ্রাহক-মুখী মানগুলি প্রকাশ করুন।
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"visible_uuid": "PRICE_FROM_SEARCH",
"setup_price": "2.00",
"monthly_price": "4.50",
"per_minute": "0.0100",
"free_minutes": "100",
"channels": "2"
}
]
}response একটি তালিকা, এমনকি একটি সারির জন্যও। status.results ফেরত আসা সারির সংখ্যা গণনা করে। ডেটাবেসের সাংখ্যিক মানগুলি স্ট্রিং হতে পারে। এন্ডপয়েন্টটি কোনো মুদ্রা ফিল্ড যোগ করে না বা মুদ্রা রূপান্তর করে না; এই উদাহরণ থেকে অনুমান না করে অ্যাকাউন্টের বিলিং মুদ্রা নিশ্চিত করুন।
মূল্য ফিল্ড
| ফিল্ড | অর্থ |
|---|---|
| visible_uuid | সংরক্ষিত মূল্য বিকল্পের দৃশ্যমান শনাক্তকারী। লুকআপটি মেলানোর সময় মূল বিকল্প ID ব্যবহার করুন। |
| setup_price | এই বিকল্পের জন্য সংরক্ষিত এককালীন সেটআপ মূল্য। |
| monthly_price | সংরক্ষিত পুনরাবৃত্ত মাসিক মূল্য। |
| per_minute, free_minutes | সংরক্ষিত ইনকামিং-কল মিনিট হার এবং অন্তর্ভুক্ত মিনিটের পরিমাণ। এগুলি আউটগোয়িং কল বা সম্ভাব্য প্রতিটি সারচার্জের মূল্য উল্লেখ করে না। |
| channels | এই বিকল্পের জন্য সংরক্ষিত চ্যানেল সংখ্যা; এটি কোনো লাইভ ক্ষমতা বা নিবন্ধন পরীক্ষা নয়। |
| yearly_price | একটি অতিরিক্ত সংরক্ষিত বার্ষিক-মূল্য ফিল্ড উপস্থিত থাকতে পারে। শূন্য নয় এমন মাসিক মূল্য এবং শূন্য বার্ষিক ফিল্ড মানেই একটি বিনামূল্যের বার্ষিক পরিকল্পনা, এমন অনুমান করবেন না। |
একাধিক মিলে যাওয়া সারি সামলান
একটি লুকআপ একাধিক সংরক্ষিত সারি ফেরত দিতে পারে। এই মেথডটি কোনো নিশ্চিত ক্রম, সর্বশেষ-সারি নির্বাচন বা নম্বর/প্রিফিক্স ফিল্টার প্রদান করে না। নীরবে প্রথম বা শেষ সারিটি বেছে নেবেন না। ফেরত আসা প্রসঙ্গটি মূল নির্বাচিত নম্বর এবং মূল্য বিকল্পের সাথে তুলনা করুন; যদি তা অস্পষ্ট বা পুরোনো থেকে যায়, তাহলে এই প্রতিক্রিয়াকে অর্ডারের মূল্য উদ্ধৃতি হিসেবে বিবেচনা না করে নম্বর অনুসন্ধানটি রিফ্রেশ করুন।
পোর্টালের অর্ডার-পর্যালোচনা ওয়ার্কফ্লো অতিরিক্ত নির্বাচন ও বৈধতা পরীক্ষা সম্পাদন করে। ধরে নেবেন না যে এই লিগ্যাসি লুকআপ সেই পরীক্ষাগুলি বাস্তবায়ন করে বা পোর্টাল যে প্রতিটি শনাক্তকারী গ্রহণ করে তা গ্রহণ করে।
খালি প্রতিক্রিয়া এবং ত্রুটি
যদি কোনো সংরক্ষিত সারি না মেলে, তাহলে বর্তমান হ্যান্ডলার কোনো JSON ফলাফল দেয় না এবং কোনো স্পষ্ট not-found প্রতিক্রিয়াও দেয় না। একটি খালি বডি মানে শূন্য মূল্য, উপলব্ধ পরিকল্পনা বা নিশ্চিত সফল লুকআপ নয়। HTTP প্রতিক্রিয়া এবং JSON কাঠামো উভয়ই পরীক্ষা করুন; অনুপস্থিত বা পার্স করা যায় না এমন মূল্য ডেটা থেকে অর্ডার করবেন না।
প্রমাণীকরণ, সোর্স-IP সীমাবদ্ধতা এবং ডেটাবেস ব্যর্থতাও একটি ব্যবহারযোগ্য প্রতিক্রিয়া পেতে বাধা দিতে পারে। ডেটাবেস এক্সেপশনের জন্য কোনো হ্যান্ডলার-নির্দিষ্ট ত্রুটি এনভেলপ নেই। প্রমাণীকৃত লুকআপ অনুপলব্ধ থাকলে আপনার নির্বাচন রিফ্রেশ করুন বা সহায়তার সাথে যোগাযোগ করুন।
প্রভাব এবং সীমা
পর্যালোচিত লুকআপটি একটি রিড কোয়েরি সম্পাদন করে এবং এতে কোনো ডেবিট, ক্রয়, রিজার্ভেশন বা প্রদানকারী-মূল্য রিফ্রেশ নেই। সংরক্ষিত মূল্য পড়া বর্তমান ইনভেন্টরি, নিয়ন্ত্রক অনুমোদন, অ্যাকাউন্টের ক্রয় অনুমতি বা চূড়ান্ত বিলিং প্রতিষ্ঠা করে না।