یہ فنکشن آپ کو فون نمبر خریدنے کی اجازت دے گا۔
اگر آپ معاملات کو سادہ رکھنا چاہتے ہیں، تو یہ صرف ڈیفالٹ 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 استعمال کریں کیونکہ اس سے پیرامیٹرز کے آگے پیچھے ہونے کا خطرہ کم ہو جاتا ہے۔