Denne funksjonen lar deg kjøpe et telefonnummer.
Hvis du vil holde det enkelt, handler det bare om å definere en standard ringto-URI (mål for innkommende anrop) (https://www.multitel.net/auth/setting , i fanen «URI Settings» (URI-innstillinger)) og deretter kalle URL-en nedenfor:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Et vellykket API-kall returnerer følgende melding:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890En mislykket samtale vil returnere en av følgende meldinger:
{"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.Hvis du må angi flere parametere, les videre:
POST URL: https://api.multitel.net/json/buynumbers/
POST-parametere:
| UserName | Påloggingsbrukernavnet ditt eller API-brukernavnet ditt |
| Password | Påloggingspassordet ditt eller API-passordet ditt |
| Number | Telefonnummeret du vil kjøpe |
| Description | Kort beskrivelse (hvis ingen er oppgitt, brukes Number som standard) |
| Type | Tilsvarer "Forward Destination" (viderekoblingsmål) i nettgrensesnittet. Mulige verdier er: 1 (for SIP) eller 2 (for Dial) |
| RingType | 1 for sekvensiell, 2 for tilfeldig, 3 for samtidig |
| Ringstyle | 1 for Ring (ringetone), 2 for Music (musikk, Early Media – lyd før samtalen besvares) |
| URI | Første SIP-URI som skal ringe (eller telefonnummer som skal ringes -- uten prefiks 00/011/+) |
| URI2 | Andre SIP-URI som skal ringes |
| URI3 | Tredje SIP-URI som skal ringes |
| SMSRingType | 1 for e-post, 2 for POST til en URL |
| SMSURI | enten e-postadresse eller POST-URL-en |
| FaxDetect | 1 for aktivert, 0 for deaktivert. Hvis ikke angitt, er standardverdien 0 |
| FaxEmail | E-postadresse for videresending av faks |
| FaxRing | Hvor mange sekunder skal vi lytte etter fakstoner? Standard er 5 |
| Vm | Talepost aktivert? Mulige verdier 1 eller 0 |
| Vmring | Hvor mange sekunder før talepost aktiveres |
| Vms2t | Tale-til-tekst for talepost (Speech 2 Text) -- 1 for aktivert, 0 for deaktivert |
| Vmemail | E-postadresse for videresending av talepost |
| Cnam | Aktiver CNAM-oppslag (mulige verdier 0 eller 1 – standard er 0) |
| Record | Ta opp telefonsamtalene (0 eller 1, standard er 0) |
| Screening | Kontroller innringere ved å be dem identifisere seg før tilkobling. Mulige verdier er 0 eller 1; standardverdien er 0. |
| Channels | Hvor mange kanaler trenger vi? Standard er 2, med mindre nummeret bare har 1 kanal tilgjengelig. Merk at for numre kun for SMS (numre uten VoIP-funksjonalitet) har denne innstillingen ingen effekt, så ikke angi den hvis du ikke trenger den. |
| Atcd | Automatisk oppdagelse av telefonsalgssamtaler (Automatic Telemarketer Call Detection) – funksjon som lytter etter automatiserte samtaler/robotsamtaler og legger på hvis en slik samtale oppdages. Mulige verdier er 1 eller 0, standard er 0 |
| SID | Sub Account ID (underkonto-ID) – definer underkontoene på https://www.multitel.net/auth/setting/ i fanen SubAccounts (underkontoer) |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... osv.
Vær oppmerksom på at parameterne som brukes for GET er nøyaktig de samme som parameterne som brukes for POST, og de skal brukes i nøyaktig samme rekkefølge som de er oppført i
tabellen ovenfor.
Vi anbefaler sterkt at du bruker POST i stedet for GET, siden det minimerer risikoen for å bytte om parametere.