এই ফাংশনটি আপনাকে একটি ফোন নম্বর কিনতে দেবে।
আপনি যদি বিষয়গুলো সহজ রাখতে চান, তাহলে শুধু একটি ডিফল্ট 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 ব্যবহার করার জোরালো পরামর্শ দিই, কারণ এতে প্যারামিটার ওলটপালট হওয়ার ঝুঁকি কমে।