Ši funkcija leis jums įsigyti telefono numerį.
Jei mėgstate paprastumą, tereikia apibrėžti numatytąjį „ringto“ URI (skambučio tikslą) (https://www.multitel.net/auth/setting , skirtuke „URI Settings“ (URI nustatymai)) ir tada iškviesti toliau pateiktą URL:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Sėkmingas API iškvietimas grąžins šį pranešimą:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Nesėkmingas skambutis grąžins vieną iš šių pranešimų:
{"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.Jei reikia nurodyti daugiau parametrų, skaitykite toliau:
POST URL: https://api.multitel.net/json/buynumbers/
POST parametrai:
| UserName | Jūsų prisijungimo naudotojo vardas arba jūsų API naudotojo vardas |
| Password | Jūsų prisijungimo slaptažodis arba jūsų API slaptažodis |
| Number | Telefono numeris, kurį norite įsigyti |
| Description | Trumpas aprašas (jei nepateiktas, pagal numatytuosius nustatymus naudojamas Number) |
| Type | Atitinka „Forward Destination“ (peradresavimo tikslas) žiniatinklio sąsajoje. Galimos reikšmės: 1 (SIP) arba 2 (Dial) |
| RingType | 1 – nuosekliajam (Sequential), 2 – atsitiktiniam (Random), 3 – vienu metu vykstančiam (Simultaneous) |
| Ringstyle | 1 – skambėjimo signalas, 2 – muzika iki atsiliepimo (Early Media) |
| URI | Pirmasis SIP URI, kuriuo skambinti (arba telefono numeris – be 00/011/+ priešdėlio) |
| URI2 | Antrasis SIP URI, kuriuo skambinti |
| URI3 | Trečiasis skambinamas SIP URI |
| SMSRingType | 1 – el. paštui, 2 – POST užklausai į URL adresą |
| SMSURI | arba el. pašto adresas, arba POST url |
| FaxDetect | 1 – įjungta, 0 – išjungta. Jei nenurodyta, numatytoji reikšmė yra 0 |
| FaxEmail | El. pašto adresas, į kurį persiųsti faksą |
| FaxRing | Kiek sekundžių turėtume klausytis fakso tonų? Numatytoji reikšmė – 5 |
| Vm | Ar įjungtas balso paštas? Galimos reikšmės – 1 arba 0 |
| Vmring | Po kiek sekundžių įsijungia balso paštas (VM) |
| Vms2t | Balso pašto kalbos į tekstą funkcija (Voicemail Speech 2 Text) -- 1 įjungta, 0 išjungta |
| Vmemail | El. pašto adresas, kuriuo persiųsti balso pašto pranešimus |
| Cnam | Įjungti CNAM paieškas (galimos reikšmės 0 arba 1 – numatytasis 0) |
| Record | Įrašyti telefoninius pokalbius (0 arba 1, numatytasis – 0) |
| Screening | Skambinančiųjų atranka: prieš sujungiant paprašyti jų prisistatyti. Galimos reikšmės yra 0 arba 1; numatytoji reikšmė — 0. |
| Channels | Kiek kanalų mums reikia? Numatytoji reikšmė – 2, nebent numeris turi tik 1 galimą kanalą. Atkreipkite dėmesį, kad tik SMS skirtiems numeriams (numeriams be VoIP galimybių) šis nustatymas neturi įtakos, todėl jo nenustatykite, jei jo nereikės. |
| Atcd | Automatinis telemarketingo skambučių aptikimas -- funkcija, kuri klauso automatinių/robotų skambučių ir padeda ragelį, jei toks skambutis aptinkamas . Galimos reikšmės 1 arba 0 , numatytoji reikšmė 0 |
| SID | Sub Account ID (antrinės paskyros ID) – antrines paskyras apibrėžkite adresu https://www.multitel.net/auth/setting/ skirtuke SubAccounts |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... ir t. t.
Atkreipkite dėmesį, kad GET naudojami parametrai yra lygiai tokie patys kaip POST naudojami parametrai ir jie turi būti naudojami tiksliai ta tvarka, kuria jie yra išvardyti
aukščiau pateiktą lentelę.
Primygtinai rekomenduojame naudoti POST, o ne GET, nes taip sumažinama parametrų sumaišymo rizika.