Tämän funktion avulla voit ostaa puhelinnumeron.
Jos haluat pitää asiat yksinkertaisina, sinun tarvitsee vain määrittää oletusarvoinen ringto-URI (saapuvan puhelun kohde) (https://www.multitel.net/auth/setting , ”URI Settings (URI-asetukset)” -välilehdellä) ja kutsua sitten alla olevaa URL-osoitetta:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Onnistunut API-kutsu palauttaa seuraavan viestin:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Epäonnistunut puhelu palauttaa jonkin seuraavista viesteistä:
{"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.Jos sinun on määritettävä lisää parametreja, jatka lukemista:
POST URL: https://api.multitel.net/json/buynumbers/
POST-parametrit:
| UserName | Kirjautumiskäyttäjänimesi tai API-käyttäjänimesi |
| Password | Kirjautumissalasanasi tai API-salasanasi |
| Number | Puhelinnumero, jonka haluat ostaa |
| Description | Lyhyt kuvaus (jos ei anneta, oletuksena Number) |
| Type | Vastaa verkkokäyttöliittymän kohtaa “Forward Destination” (soitonsiirron kohde). Mahdolliset arvot ovat: 1 (SIP:lle) tai 2 (Dialille) |
| RingType | 1 = peräkkäinen (Sequential), 2 = satunnainen (Random), 3 = samanaikainen (Simultaneous) |
| Ringstyle | 1: Ring (soittoääni), 2: Music (musiikki, Early Media – ääni ennen puheluun vastaamista) |
| URI | Ensimmäinen soitettava SIP URI (tai valittava puhelinnumero -- älä käytä 00/011/+ -etuliitettä) |
| URI2 | Toinen soitettava SIP URI |
| URI3 | Kolmas soitettava SIP URI |
| SMSRingType | 1 sähköpostille, 2 POST-pyynnölle URL-osoitteeseen |
| SMSURI | joko sähköpostiosoite tai POST-url |
| FaxDetect | 1 tarkoittaa käytössä, 0 pois käytöstä. Jos arvoa ei määritetä, oletuksena on 0 |
| FaxEmail | Sähköpostiosoite, johon faksi välitetään |
| FaxRing | Kuinka monta sekuntia meidän pitäisi kuunnella faksausääniä? Oletus on 5 |
| Vm | Onko puheposti käytössä? Mahdolliset arvot 1 tai 0 |
| Vmring | Kuinka monen sekunnin kuluttua vastaaja (VM) aktivoituu |
| Vms2t | Voicemail Speech 2 Text (puhepostin puheesta tekstiksi) -- 1 = käytössä, 0 = pois käytöstä |
| Vmemail | Sähköpostiosoite, johon vastaajaviestit välitetään |
| Cnam | Ota CNAM-haut käyttöön (mahdolliset arvot 0 tai 1 – oletus on 0) |
| Record | Tallenna puhelinkeskustelut (0 tai 1, oletus on 0) |
| Screening | Seulo soittajat pyytämällä heitä esittäytymään ennen yhdistämistä. Mahdolliset arvot ovat 0 tai 1; oletusarvo on 0. |
| Channels | Montako kanavaa tarvitsemme? Oletuksena 2, ellei numerolla ole vain 1 kanava käytettävissä. Huomaa, että vain SMS-numeroilla (numerot, joilla ei ole VoIP-ominaisuutta) tällä asetuksella ei ole vaikutusta, joten älä aseta sitä, jos et tarvitse sitä. |
| Atcd | Automaattinen puhelinmyyjien puheluiden tunnistus -- ominaisuus, joka kuuntelee automatisoituja/robottipuheluita ja katkaisee puhelun, jos sellainen havaitaan. Mahdolliset arvot 1 tai 0, oletusarvo 0 |
| SID | Sub Account ID (alatilin tunnus) – määritä alatilit kohdassa https://www.multitel.net/auth/setting/ välilehdellä SubAccounts (alatilit) |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... jne.
Huomaa, että GET-menetelmässä käytetyt parametrit ovat täsmälleen samat kuin POST-menetelmässä käytetyt parametrit, ja niitä tulee käyttää täsmälleen siinä järjestyksessä kuin ne on lueteltu kohdassa
yllä oleva taulukko.
Suosittelemme vahvasti POST-menetelmän käyttöä GET-menetelmän sijaan, sillä se minimoi parametrien sekoittumisen riskin.