Denne funktion giver dig mulighed for at købe et telefonnummer.
Hvis du vil holde det enkelt, handler det blot om at definere en standard-ringto-URI (https://www.multitel.net/auth/setting , under fanen "URI-indstillinger (URI Settings)") og derefter kalde URL'en nedenfor:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Et vellykket API-kald returnerer følgende besked:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Et mislykket opkald returnerer en af følgende meddelelser:
{"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 har brug for at angive flere parametre, så læs videre:
POST URL: https://api.multitel.net/json/buynumbers/
POST-parametre:
| UserName | Dit login-brugernavn eller dit API-brugernavn |
| Password | Din loginadgangskode eller din API-adgangskode |
| Number | Det telefonnummer, du vil købe |
| Description | Kort beskrivelse (hvis ingen angives, bruges værdien fra feltet Number) |
| Type | Svarer til "Forward Destination" i webgrænsefladen. Mulige værdier er: 1 (for SIP) eller 2 (for Dial) |
| RingType | 1 for sekventiel, 2 for tilfældig, 3 for samtidig |
| Ringstyle | 1 for ringetone, 2 for musik (Early Media) |
| URI | Første SIP-URI, der skal ringes op (eller telefonnummer, der skal ringes til – uden 00/011/+ foran, tak) |
| URI2 | Anden SIP URI, der skal ringe |
| URI3 | Tredje SIP-URI, der skal ringes til |
| SMSRingType | 1 for e-mail, 2 for en POST-anmodning til en URL |
| SMSURI | enten e-mailadresse eller POST-URL'en |
| FaxDetect | 1 for aktiveret, 0 for deaktiveret. Hvis intet er angivet, er standardværdien 0 |
| FaxEmail | E-mail, hvortil faxen skal videresendes |
| FaxRing | Hvor mange sekunder skal vi lytte efter faxtoner? Standard er 5 |
| Vm | Voicemail aktiveret? Mulige værdier 1 eller 0 |
| Vmring | Hvor mange sekunder, før telefonsvareren (VM) aktiveres |
| Vms2t | Transskription af voicemail (Speech 2 Text) -- 1 for aktiveret, 0 for deaktiveret |
| Vmemail | E-mailadresse, hvortil telefonsvarerbeskeder skal videresendes |
| Cnam | Aktivér CNAM-opslag (mulige værdier 0 eller 1 – standard er 0) |
| Record | Optag telefonsamtalerne (0 eller 1, standard er 0) |
| Screening | Screen opkaldere (bed dem identificere sig, før de bliver forbundet - mulige værdier er 0 eller 1, standard er 0 |
| Channels | Hvor mange kanaler har vi brug for? Standard er 2, medmindre nummeret kun har 1 kanal til rådighed. Bemærk, at for numre kun til SMS (numre uden VoIP-funktion) har denne indstilling ingen effekt, så lad være med at angive den, hvis du ikke har brug for den. |
| Atcd | Automatisk registrering af telemarketingopkald (Automatic Telemarketer Call Detection) -- funktion, der lytter efter automatiserede opkald/robotopkald og lægger på, hvis et sådant opkald registreres. Mulige værdier er 1 eller 0, standard er 0 |
| SID | Underkonto-ID – definer dine underkonti ved https://www.multitel.net/auth/setting/ under fanen Underkonti (SubAccounts) |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... osv.
Bemærk, at de parametre, der bruges til GET, er nøjagtig de samme som de parametre, der bruges til POST, og at de skal bruges i nøjagtig den rækkefølge, som de er anført i
tabellen ovenfor.
Vi anbefaler kraftigt, at du bruger POST i stedet for GET, da det minimerer risikoen for at forveksle parametre.