Ova funkcija omogućit će vam kupnju telefonskog broja.
Za jednostavniju uporabu definirajte zadani ringto URI, odnosno URI odredišta za poziv (https://www.multitel.net/auth/setting, na kartici "URI Settings" — postavke URI-ja), a zatim pozovite URL u nastavku:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Uspješan API poziv vratit će sljedeću poruku:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Neuspješan poziv vratit će jednu od sljedećih poruka:
{"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.Ako trebate navesti više parametara, čitajte dalje:
POST URL: https://api.multitel.net/json/buynumbers/
POST parametri:
| UserName | Vaše korisničko ime za prijavu ili vaše API korisničko ime |
| Password | Vaša lozinka za prijavu ili vaša API lozinka |
| Number | Telefonski broj koji želite kupiti |
| Description | Kratki opis (ako nije naveden, zadano je Number) |
| Type | Ekvivalent je opciji „Forward Destination“ (odredište preusmjeravanja) iz web-sučelja. Moguće vrijednosti su: 1 (za SIP) ili 2 (za Dial) |
| RingType | 1 za slijedno (Sequential), 2 za nasumično (Random), 3 za istodobno (Simultaneous) |
| Ringstyle | 1 za zvonjenje, 2 za glazbu prije odgovora (Early Media) |
| URI | Prvi SIP URI koji treba zvoniti (ili telefonski broj za biranje -- molimo bez prefiksa 00/011/+) |
| URI2 | Drugi SIP URI za zvonjenje |
| URI3 | Treći SIP URI za zvonjenje |
| SMSRingType | 1 za e-poštu, 2 za POST zahtjev na URL adresu |
| SMSURI | ili adresa e-pošte, ili POST url |
| FaxDetect | 1 za omogućeno, 0 za onemogućeno. Ako nije navedeno, zadana vrijednost je 0 |
| FaxEmail | E-pošta na koju se prosljeđuje faks |
| FaxRing | Koliko sekundi trebamo osluškivati tonove faksa? Zadano je 5 |
| Vm | Je li govorna pošta uključena? Moguće vrijednosti 1 ili 0 |
| Vmring | Nakon koliko sekundi se uključuje govorna pošta |
| Vms2t | Pretvaranje govora iz glasovne pošte u tekst (Voicemail Speech 2 Text) -- 1 za omogućeno, 0 za onemogućeno |
| Vmemail | E-adresa na koju se prosljeđuju govorne poruke |
| Cnam | Omogućite CNAM pretraživanja (moguće vrijednosti 0 ili 1 - zadano je 0) |
| Record | Snimajte telefonske razgovore (0 ili 1, zadano je 0) |
| Screening | Provjera pozivatelja (traži se da se predstave prije spajanja - moguće vrijednosti 0 ili 1, zadano 0) |
| Channels | Koliko kanala trebamo? Zadano je 2, osim ako broj ima samo 1 kanal na raspolaganju. Imajte na umu da za brojeve samo za SMS (brojeve koji nemaju VoIP mogućnost) ova postavka nema učinka, stoga je nemojte postavljati ako vam neće trebati. |
| Atcd | Automatic Telemarketer Call Detection (automatsko otkrivanje telemarketinških poziva) -- značajka koja prisluškuje automatizirane/robotske pozive i prekida vezu ako se takav poziv otkrije . Moguće vrijednosti 1 ili 0 , zadano 0 |
| SID | Sub Account ID (ID podračuna) – podračune definirajte na https://www.multitel.net/auth/setting/ u kartici SubAccounts |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... itd.
Imajte na umu da su parametri koji se koriste za GET potpuno isti kao parametri koji se koriste za POST te ih treba koristiti točno onim redoslijedom kojim su navedeni u
gornju tablicu.
Toplo preporučujemo da koristite POST umjesto GET jer se time smanjuje rizik od zamjene parametara.