BuyNumbers REST ফাংশন

এই ফাংশনটি আপনাকে একটি ফোন নম্বর কিনতে দেবে।


আপনি যদি বিষয়গুলো সহজ রাখতে চান, তাহলে শুধু একটি ডিফল্ট ringto URI সংজ্ঞায়িত করতে হবে (https://www.multitel.net/auth/setting, "URI সেটিংস" ট্যাবে) এবং তারপর নিচের URL-এ কল করতে হবে:

https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER

সফল API কলের উত্তরে এই বার্তা আসবে:

{"DATA":[{"RETURN":1234567890}]}  <= this is presuming you were trying to purchase phone number 1234567890

একটি অসফল কল নিম্নলিখিত বার্তাগুলির একটি ফেরত দেবে:

{"DATA":[{"RETURN":99}]}      <== not enough balance to purchase number
{"DATA":[{"RETURN":100}]}    <== not authenticated (Check username/password)
{"DATA":[{"RETURN":-165}]}   <== number has already been sold (check your account, possibly you hit the refresh button twice and you already purchased the number?)
{"DATA":[{"RETURN":-220}]}   <== number is reserved (might happen when number was just released, please try again in a few minutes)
{"DATA":[{"RETURN":-275}]}   <== this number does not exist in our inventory anymore
{"DATA":[{"RETURN":-1210}]} <== number not cleared
{"DATA":[{"RETURN":-1265}]} <== documentation required - usually proof of address / ID card copy (please contact us for more info.

আপনার আরও প্যারামিটার নির্দিষ্ট করার প্রয়োজন হলে, পড়তে থাকুন:

POST URL: https://api.multitel.net/json/buynumbers/

POST প্যারামিটার:

UserName লগইন করার ব্যবহারকারীনাম অথবা আপনার API ব্যবহারকারীনাম
Password আপনার লগইন পাসওয়ার্ড অথবা আপনার API পাসওয়ার্ড
Number যে ফোন নম্বরটি আপনি কিনতে চান
Description সংক্ষিপ্ত বিবরণ (না দিলে ডিফল্ট হিসেবে নম্বরের Number ফিল্ডের মান ব্যবহৃত হয়)
Type ওয়েব ইন্টারফেসের "ফরওয়ার্ড করার গন্তব্য"-এর সমতুল্য। সম্ভাব্য মান: 1 (SIP-এর জন্য) অথবা 2 (Dial-এর জন্য)
RingType 1 ক্রমানুসারে কলের জন্য, 2 এলোমেলোভাবে কলের জন্য, 3 একসঙ্গে কলের জন্য
Ringstyle রিংটোনের জন্য 1, সংগীতের জন্য 2 (প্রাথমিক মিডিয়া)
URI যে প্রথম SIP URI-তে রিং হবে (অথবা যে ফোন নম্বরে ডায়াল করতে হবে -- দয়া করে 00/011/+ প্রিফিক্স ছাড়া)
URI2 রিং করার জন্য দ্বিতীয় SIP URI
URI3 রিং করার জন্য তৃতীয় SIP URI
SMSRingType ইমেইলের জন্য 1, URL-এ POST অনুরোধের জন্য 2
SMSURI ইমেইল ঠিকানা অথবা POST অনুরোধের URL
FaxDetect সক্রিয় থাকলে 1, নিষ্ক্রিয় থাকলে 0। নির্দিষ্ট করা না থাকলে ডিফল্ট মান 0 হবে
FaxEmail ফ্যাক্স যে ইমেইলে ফরওয়ার্ড করা হবে
FaxRing ফ্যাক্স টোনের জন্য আমাদের কত সেকেন্ড শোনা উচিত? ডিফল্ট 5
Vm ভয়েসমেইল সক্রিয়? সম্ভাব্য মান 1 বা 0
Vmring ভয়েসমেইল (VM) চালু হওয়ার আগে কত সেকেন্ড অপেক্ষা করবে
Vms2t ভয়েসমেইলের কথাকে লেখায় রূপান্তর (Speech 2 Text) -- সক্রিয় করার জন্য 1, নিষ্ক্রিয় করার জন্য 0
Vmemail যে ইমেইল ঠিকানায় ভয়েসমেইল ফরওয়ার্ড করা হবে
Cnam CNAM লুকআপ সক্রিয় করুন (সম্ভাব্য মান 0 বা 1 - ডিফল্ট 0)
Record ফোন কথোপকথন রেকর্ড করুন (0 অথবা 1, ডিফল্ট 0)
Screening কলারদের স্ক্রিন করুন (সংযুক্ত করার আগে তাদের নিজেদের পরিচয় দিতে বলুন - সম্ভাব্য মান 0 বা 1, ডিফল্ট 0
Channels আমাদের কতগুলো চ্যানেল প্রয়োজন? ডিফল্ট হলো 2, তবে নম্বরে কেবল 1টি চ্যানেল উপলব্ধ থাকলে তা প্রযোজ্য নয়। মনে রাখবেন, শুধু SMS-এর নম্বরগুলোর (যেসব নম্বরে VoIP সক্ষমতা নেই) ক্ষেত্রে এই সেটিংয়ের কোনো প্রভাব নেই, তাই প্রয়োজন না হলে এটি সেট করবেন না।
Atcd স্বয়ংক্রিয় টেলিমার্কেটার কল শনাক্তকরণ -- এই ফিচারটি স্বয়ংক্রিয়/রোবো কল শোনে এবং এমন কল শনাক্ত হলে কল কেটে দেয়। সম্ভাব্য মান 1 বা 0, ডিফল্ট 0
SID উপ-অ্যাকাউন্ট ID -- https://www.multitel.net/auth/setting/-এ উপ-অ্যাকাউন্ট ট্যাবে আপনার উপ-অ্যাকাউন্টগুলো নির্ধারণ করুন

GET URL:

https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... ইত্যাদি


অনুগ্রহ করে মনে রাখবেন যে GET-এর জন্য ব্যবহৃত প্যারামিটারগুলি POST-এর জন্য ব্যবহৃত প্যারামিটারগুলির ঠিক একই এবং সেগুলি যে সঠিক ক্রমে তালিকাভুক্ত আছে সেই ক্রমেই ব্যবহার করা উচিত

উপরের টেবিল।

আমরা GET-এর পরিবর্তে POST ব্যবহার করার জোরালো পরামর্শ দিই, কারণ এতে প্যারামিটার ওলটপালট হওয়ার ঝুঁকি কমে।

ডকুমেন্টেশন খুঁজুন