Met deze functie kunt u een telefoonnummer kopen.
Als u het eenvoudig wilt houden, hoeft u alleen een standaard ringto-URI te definiëren (https://www.multitel.net/auth/setting , op het tabblad "URI-instellingen (URI Settings)") en vervolgens de onderstaande URL aan te roepen:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Een geslaagde API-aanroep geeft het volgende bericht terug:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Een mislukt gesprek geeft een van de volgende berichten terug:
{"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.Als u meer parameters moet opgeven, lees verder:
POST URL: https://api.multitel.net/json/buynumbers/
POST-parameters:
| UserName | Uw login-gebruikersnaam of uw API-gebruikersnaam |
| Password | Uw inlogwachtwoord of uw API-wachtwoord |
| Number | Het telefoonnummer dat u wilt kopen |
| Description | Korte omschrijving (indien niet opgegeven, wordt de waarde van het veld Number gebruikt) |
| Type | Gelijk aan "Forward Destination" in de webinterface. Mogelijke waarden zijn: 1 (voor SIP) of 2 (voor Dial) |
| RingType | 1 voor Sequentieel, 2 voor Willekeurig, 3 voor Gelijktijdig |
| Ringstyle | 1 voor beltoon, 2 voor muziek (Early Media) |
| URI | Eerste SIP URI om te laten overgaan (of te bellen telefoonnummer -- geen 00/011/+ voorvoegsel alstublieft) |
| URI2 | Tweede SIP-URI om te laten overgaan |
| URI3 | Derde SIP-URI om te laten overgaan |
| SMSRingType | 1 voor e-mail, 2 voor een POST-verzoek naar een URL |
| SMSURI | ofwel e-mailadres, ofwel de POST-url |
| FaxDetect | 1 voor ingeschakeld, 0 voor uitgeschakeld. Indien niet opgegeven, is de standaardwaarde 0 |
| FaxEmail | E-mailadres waarnaar de fax wordt doorgestuurd |
| FaxRing | Hoeveel seconden moeten wij luisteren naar faxtonen? Standaard 5 |
| Vm | Voicemail ingeschakeld? Mogelijke waarden 1 of 0 |
| Vmring | Hoeveel seconden voordat de voicemail wordt geactiveerd |
| Vms2t | Voicemailtranscriptie (Speech 2 Text) -- 1 voor ingeschakeld, 0 voor uitgeschakeld |
| Vmemail | E-mailadres waarnaar voicemails worden doorgestuurd |
| Cnam | CNAM-lookups inschakelen (mogelijke waarden 0 of 1 -standaard 0) |
| Record | Telefoongesprekken opnemen (0 of 1, standaard 0) |
| Screening | Bellers screenen (vraag hen zich te identificeren voordat ze worden doorverbonden - mogelijke waarden 0 of 1, standaard 0 |
| Channels | Hoeveel kanalen hebben we nodig? Standaard 2, tenzij het nummer slechts 1 kanaal beschikbaar heeft. Houd er rekening mee dat deze instelling bij nummers die alleen SMS ondersteunen (nummers zonder VoIP-mogelijkheden) geen effect heeft; stel haar dus niet in als u haar niet nodig hebt. |
| Atcd | Automatische herkenning van telemarketingoproepen (Automatic Telemarketer Call Detection) -- functie die luistert naar geautomatiseerde/robotgesprekken en ophangt als zo'n gesprek wordt gedetecteerd . Mogelijke waarden 1 of 0 , standaard 0 |
| SID | Subaccount-ID (Sub Account ID) -- definieer uw subaccounts op https://www.multitel.net/auth/setting/ op het tabblad Subaccounts (SubAccounts) |
GET-URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... enz.
Houd er rekening mee dat de parameters die voor GET worden gebruikt exact dezelfde zijn als de parameters die voor POST worden gebruikt en dat ze in exact dezelfde volgorde moeten worden gebruikt als waarin ze worden vermeld in
de bovenstaande tabel.
Wij raden sterk aan POST te gebruiken in plaats van GET, omdat dit het risico verkleint dat parameters door elkaar worden gehaald.