Den här funktionen låter dig köpa ett telefonnummer.
Om du vill hålla det enkelt handlar det bara om att definiera en standard-ringto-URI (destination för inkommande samtal) (https://www.multitel.net/auth/setting , på fliken "URI Settings (URI-inställningar)") och sedan anropa URL:en nedan:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Ett lyckat API-anrop returnerar följande meddelande:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Ett misslyckat samtal returnerar ett av följande meddelanden:
{"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.Om du behöver ange fler parametrar, läs vidare:
POST URL: https://api.multitel.net/json/buynumbers/
POST-parametrar:
| UserName | Ditt inloggningsanvändarnamn eller ditt API-användarnamn |
| Password | Ditt inloggningslösenord eller ditt API-lösenord |
| Number | Telefonnumret du vill köpa |
| Description | Kort beskrivning (om ingen anges används Number som standard) |
| Type | Motsvarar "Forward Destination" (vidarekopplingsmål) i webbgränssnittet. Möjliga värden är: 1 (för SIP) eller 2 (för Dial) |
| RingType | 1 för Sekventiell, 2 för Slumpmässig, 3 för Samtidig |
| Ringstyle | 1 för Ring (ringsignal), 2 för Music (musik, Early Media – ljud innan samtalet besvaras) |
| URI | Första SIP-URI att ringa (eller telefonnummer att ringa -- inget 00/011/+ prefix, tack) |
| URI2 | Andra SIP-URI att ringa |
| URI3 | Tredje SIP-URI att ringa |
| SMSRingType | 1 för e-post, 2 för POST till en URL |
| SMSURI | antingen e-postadress eller POST-URL |
| FaxDetect | 1 för aktiverad, 0 för inaktiverad. Om inget anges är standardvärdet 0 |
| FaxEmail | E-postadress dit faxet ska vidarebefordras |
| FaxRing | Hur många sekunder ska vi lyssna efter faxtoner? Standard är 5 |
| Vm | Är röstbrevlåda aktiverad? Möjliga värden är 1 eller 0 |
| Vmring | Hur många sekunder innan röstbrevlådan svarar |
| Vms2t | Voicemail Speech 2 Text (tal till text för röstbrevlåda) -- 1 för aktiverad, 0 för inaktiverad |
| Vmemail | E-postadress dit röstmeddelanden ska vidarebefordras |
| Cnam | Aktivera CNAM-slagningar (möjliga värden 0 eller 1 – standard är 0) |
| Record | Spela in telefonsamtalen (0 eller 1, standard är 0) |
| Screening | Kontrollera uppringare genom att be dem identifiera sig innan de kopplas fram. Möjliga värden är 0 eller 1, standardvärdet är 0. |
| Channels | Hur många kanaler behöver vi? Standardvärdet är 2 om inte numret bara har 1 kanal tillgänglig. Observera att för nummer som endast stöder SMS (nummer utan VoIP-funktion) har den här inställningen ingen effekt, så ange den inte om du inte behöver den. |
| Atcd | Automatisk detektering av telemarketingsamtal -- funktion som lyssnar efter automatiserade samtal/robotsamtal och lägger på om ett sådant samtal upptäcks. Möjliga värden är 1 eller 0, standardvärdet är 0 |
| SID | Sub Account ID (underkonto-ID) – ange underkontona på https://www.multitel.net/auth/setting/ under fliken SubAccounts (underkonton) |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... osv.
Observera att parametrarna som används för GET är exakt desamma som parametrarna som används för POST och att de ska användas i exakt den ordning som de anges i
tabellen ovan.
Vi rekommenderar starkt att du använder POST i stället för GET eftersom det minimerar risken för att parametrar förväxlas.