Hierdie funksie sal jou toelaat om 'n telefoonnommer te koop.
As jy dit eenvoudig wil hou, hoef jy net ’n verstek-ringto-URI te bepaal (https://www.multitel.net/auth/setting , op die "URI-instellings"-oortjie) en dan die URL hieronder aan te roep:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
’n Suksesvolle API-aanroep gee die volgende boodskap terug:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890'n Onsuksesvolle oproep sal een van die volgende boodskappe teruggee:
{"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.As jy meer parameters moet spesifiseer, lees verder:
POST URL: https://api.multitel.net/json/buynumbers/
POST-parameters:
| UserName | Jou aanmeldgebruikersnaam of jou API-gebruikersnaam |
| Password | Jou aanmeldwagwoord of jou API-wagwoord |
| Number | Die telefoonnommer wat jy wil koop |
| Description | Kort beskrywing (indien geen verskaf word nie, word Number, die nommerveld, by verstek gebruik) |
| Type | Gelykstaande aan "Aanstuurbestemming" vanaf die webkoppelvlak. Moontlike waardes is : 1 (vir SIP) of 2 (vir Dial) |
| RingType | 1 vir Opeenvolgend, 2 vir Lukraak, 3 vir Gelyktydig |
| Ringstyle | 1 vir luitoon, 2 vir musiek (vroeë media) |
| URI | Eerste SIP URI om te lui (of foonnommer om te skakel -- geen 00/011/+ voorvoegsel asseblief nie) |
| URI2 | Tweede SIP URI om te lui |
| URI3 | Derde SIP-URI om te lui |
| SMSRingType | 1 vir e-pos, 2 vir ’n POST-versoek na ’n URL |
| SMSURI | óf E-posadres, óf die POST-url |
| FaxDetect | 1 vir geaktiveer, 0 vir gedeaktiveer. As dit nie gespesifiseer word nie, is die verstek 0 |
| FaxEmail | E-pos waarheen om faks aan te stuur |
| FaxRing | Hoeveel sekondes moet ons vir fakstone luister? Verstek is 5 |
| Vm | Stempos geaktiveer? Moontlike waardes 1 of 0 |
| Vmring | Hoeveel sekondes voordat VM oorneem |
| Vms2t | Stempos: spraak na teks (Speech 2 Text) -- 1 vir geaktiveer, 0 vir gedeaktiveer |
| Vmemail | E-posadres waarheen om stempos aan te stuur |
| Cnam | Aktiveer CNAM-opsoeke (moontlike waardes 0 of 1 - verstek is 0) |
| Record | Neem die telefoonoproepe op (0 of 1, verstek is 0) |
| Screening | Sif bellers (vra hulle om hulself te identifiseer voordat hulle verbind word - moontlike waardes 0 of 1, verstek is 0 |
| Channels | Hoeveel kanale het ons nodig? Verstek is 2 tensy die nommer slegs 1 kanaal beskikbaar het. Let daarop dat vir SMS-alleen-nommers (nommers wat geen VoIP-vermoë het nie), hierdie instelling geen effek het nie, so moenie dit stel as jy dit nie nodig sal hê nie. |
| Atcd | Outomatiese Telemarketer-Oproepbespeuring -- kenmerk wat luister vir outomatiese/robo-oproepe en neerlê as so 'n oproep bespeur word . Moontlike waardes 1 of 0 , verstek is 0 |
| SID | Subrekening-ID -- definieer jou subrekeninge by https://www.multitel.net/auth/setting/ in die Subrekeninge-oortjie |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... ens.
Let asseblief daarop dat die parameters wat vir GET gebruik word presies dieselfde is as die parameters wat vir POST gebruik word en dat hulle in presies dieselfde volgorde gebruik moet word as waarin hulle gelys word in
die tabel hierbo.
Ons beveel sterk aan dat jy POST in plaas van GET gebruik, aangesien dit die risiko verminder dat parameters verwissel word.