Ky funksion ju lejon të blini një numër telefoni.
Nëse dëshironi t'i mbani gjërat të thjeshta, mjafton të përcaktoni një URI ringto të parazgjedhur (adresë destinacioni për thirrjet hyrëse) (https://www.multitel.net/auth/setting , në skedën “URI Settings (cilësimet e URI-së)”) dhe më pas të thirrni URL-në më poshtë:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Një thirrje e suksesshme API do të kthejë mesazhin e mëposhtëm:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Një thirrje API e pasuksesshme do të kthejë një nga mesazhet e mëposhtme:
{"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.Nëse duhet të specifikoni më shumë parametra, lexoni më tej:
POST URL: https://api.multitel.net/json/buynumbers/
Parametrat POST:
| UserName | Emri juaj i përdoruesit për hyrje ose emri juaj i përdoruesit API |
| Password | Fjalëkalimi juaj i hyrjes ose fjalëkalimi juaj API |
| Number | Numri i telefonit që dëshironi të blini |
| Description | Përshkrim i shkurtër (nëse nuk jepet, parazgjedhja është Number) |
| Type | Ekuivalente me “Forward Destination” nga ndërfaqja e internetit. Vlerat e mundshme janë: 1 (për SIP) ose 2 (për Dial) |
| RingType | 1 për thirrje me radhë, 2 për thirrje të rastësishme, 3 për thirrje të njëkohshme |
| Ringstyle | 1 për Ring (zile), 2 për Muzikë (Early Media – audio para përgjigjes së thirrjes) |
| URI | SIP URI-ja e parë që do të bjerë zilja (ose numri i telefonit që do të thirret -- pa prefiks 00/011/+, ju lutemi) |
| URI2 | URI-ja e dytë SIP për t'u thirrur |
| URI3 | URI-ja e tretë SIP ku do të bjerë zilja |
| SMSRingType | 1 për email, 2 për dërgim të një kërkese POST në një URL |
| SMSURI | ose adresa E-Mail, ose URL-ja POST |
| FaxDetect | 1 për aktivizuar, 0 për çaktivizuar. Nëse nuk specifikohet, vlera e paracaktuar është 0 |
| FaxEmail | E-mail ku të përcillni faksin |
| FaxRing | Sa sekonda duhet të dëgjojmë për tonet e faksit? Parazgjedhja është 5 |
| Vm | Posta zanore i aktivizuar ? Vlera të mundshme 1 ose 0 |
| Vmring | Sa sekonda kalojnë para se të aktivizohet posta zanore (VM) |
| Vms2t | Shndërrimi i postës zanore në tekst (Voicemail Speech 2 Text) -- 1 për aktivizuar, 0 për çaktivizuar |
| Vmemail | Adresa e email-it ku të përcillen mesazhet zanore (VoiceMails) |
| Cnam | Aktivizoni kërkimet CNAM (vlerat e mundshme 0 ose 1 - vlera e parazgjedhur është 0) |
| Record | Regjistroni bisedat telefonike (0 ose 1, parazgjedhja është 0) |
| Screening | Kërkojuni telefonuesve të identifikohen përpara lidhjes (vlerat e mundshme janë 0 ose 1; vlera e paracaktuar është 0). |
| Channels | Sa kanale na duhen? Parazgjedhja është 2, përveç nëse numri ka vetëm 1 kanal në dispozicion. Ju lutem vini re se për numrat Vetëm SMS (Numra që nuk kanë aftësi VoIP), ky cilësim nuk ka efekt, prandaj mos e caktoni nëse nuk do t'ju duhet. |
| Atcd | Zbulimi Automatik i Thirrjeve të Telemarketingut -- veçori që dëgjon për thirrje të automatizuara/robo dhe e mbyll thirrjen nëse zbulohet një thirrje e tillë. Vlerat e mundshme 1 ose 0, parazgjedhja është 0 |
| SID | Sub Account ID (identifikuesi i nënllogarisë) – përcaktoni nënllogaritë tuaja te https://www.multitel.net/auth/setting/ në skedën SubAccounts |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... etj
Ju lutem vini re se parametrat e përdorur për GET janë saktësisht të njëjtë me parametrat e përdorur për POST dhe ato duhet të përdoren në rendin e saktë siç janë renditur në
tabela më sipër.
Ne rekomandojmë fuqimisht që të përdorni POST në vend të GET, pasi minimizon rrezikun e ngatërrimit të parametrave.