Ова функција омогућава куповину телефонског броја.
Ако желите да све буде једноставно, довољно је да дефинишете подразумевани 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 за звоњење, 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 | После колико секунди се укључује говорна пошта |
| 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 (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, јер се тиме смањује ризик од замене параметара.