Тази функция ще ви позволи да закупите телефонен номер.
Ако предпочитате нещата да са прости, достатъчно е да дефинирате ringto URI по подразбиране (адрес за входящите повиквания) (https://www.multitel.net/auth/setting , в раздела „URI Settings (настройки на 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Неуспешно извикване на API ще върне едно от следните съобщения:
{"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 | Еквивалент на "Forward Destination" (цел на пренасочването) от уеб интерфейса. Възможните стойности са: 1 (за SIP) или 2 (за Dial — набиране) |
| RingType | 1 за последователно, 2 за произволно, 3 за едновременно |
| Ringstyle | 1 за сигнал за позвъняване (Ring), 2 за музика (Early Media – аудио преди отговор на повикването) |
| URI | Първи SIP URI за позвъняване (или телефонен номер за набиране -- моля, без префикс 00/011/+) |
| URI2 | Втори SIP URI за звънене |
| URI3 | Трети SIP URI за позвъняване |
| SMSRingType | 1 за имейл, 2 за POST заявка към URL адрес |
| SMSURI | или имейл адрес, или POST url |
| FaxDetect | 1 за включено, 0 за изключено. Ако не е зададено, по подразбиране е 0 |
| FaxEmail | Имейл, към който да се препраща факсът |
| FaxRing | Колко секунди да слушаме за факс тонове? По подразбиране е 5 |
| Vm | Включена ли е гласовата поща? Възможни стойности: 1 или 0 |
| Vmring | Колко секунди изчаква, преди да се включи гласовата поща (VM) |
| Vms2t | Voicemail 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 | Sub Account ID (идентификатор на подакаунта) – дефинирайте подакаунтите си на https://www.multitel.net/auth/setting/ в раздела SubAccounts |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... и т.н.
Моля, имайте предвид, че параметрите, използвани за GET, са абсолютно същите като параметрите, използвани за POST, и трябва да се използват точно в реда, в който са изброени в
таблицата по-горе.
Силно препоръчваме да използвате POST вместо GET, тъй като това свежда до минимум риска от размяна на параметри.