Šī funkcija ļaus jums iegādāties tālruņa numuru.
Ja vēlaties visu vienkārši, pietiek definēt noklusējuma ringto URI (ienākošā zvana galamērķi) (https://www.multitel.net/auth/setting , cilnē "URI Settings (URI iestatījumi)") un pēc tam izsaukt tālāk norādīto URL:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Veiksmīgs API izsaukums atgriezīs šādu ziņojumu:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Neveiksmīgs zvans atgriezīs vienu no šiem ziņojumiem:
{"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.Ja jānorāda papildu parametri, lasiet tālāk:
POST URL: https://api.multitel.net/json/buynumbers/
POST parametri:
| UserName | Jūsu pieteikšanās lietotājvārds vai jūsu API lietotājvārds |
| Password | Jūsu pieteikšanās parole vai jūsu API parole |
| Number | Tālruņa numurs, kuru vēlaties iegādāties |
| Description | Īss apraksts (ja nav norādīts, pēc noklusējuma tiek izmantots Number) |
| Type | Atbilst “Forward Destination” (pāradresācijas galamērķis) tīmekļa saskarnē. Iespējamās vērtības: 1 (SIP) vai 2 (Dial) |
| RingType | 1 secīgai izvēlei (Sequential), 2 nejaušai izvēlei (Random), 3 vienlaicīgai izvēlei (Simultaneous) |
| Ringstyle | 1: Ring (zvana signāls), 2: Music (mūzika, Early Media – audio pirms atbildes uz zvanu) |
| URI | Pirmais SIP URI, uz kuru zvanīt (vai tālruņa numurs, uz kuru zvanīt -- lūdzu, bez 00/011/+ prefiksa) |
| URI2 | Otrs izsaucamais SIP URI |
| URI3 | Trešais SIP URI, uz kuru zvanīt |
| SMSRingType | 1 e-pastam, 2 POST pieprasījumam uz URL adresi |
| SMSURI | vai nu e-pasta adrese, vai POST url |
| FaxDetect | 1 — iespējots, 0 — atspējots. Ja nav norādīts, noklusējuma vērtība ir 0 |
| FaxEmail | E-pasts, uz kuru pārsūtīt faksu |
| FaxRing | Cik sekundes mums jāieklausās faksa toņos? Noklusējums ir 5 |
| Vm | Balss pasts iespējots? Iespējamās vērtības 1 vai 0 |
| Vmring | Cik sekundes pirms ieslēdzas balss pasts |
| Vms2t | Balss pasta runas pārvēršana tekstā (Speech 2 Text) -- 1 nozīmē iespējots, 0 nozīmē atspējots |
| Vmemail | E-pasta adrese, uz kuru pārsūtīt balss pasta ziņojumus |
| Cnam | Iespējot CNAM uzmeklēšanu (iespējamās vērtības 0 vai 1 — pēc noklusējuma 0) |
| Record | Ierakstīt telefona sarunas (0 vai 1, noklusējums ir 0) |
| Screening | Pārbaudīt zvanītājus, lūdzot tiem pirms savienošanas sevi identificēt. Iespējamās vērtības ir 0 vai 1; noklusējuma vērtība ir 0. |
| Channels | Cik kanālu mums vajag? Pēc noklusējuma 2, ja vien numuram nav pieejams tikai 1 kanāls. Ņemiet vērā, ka numuriem tikai ar SMS (numuriem bez VoIP iespējām) šim iestatījumam nav nekādas ietekmes, tāpēc nenorādiet to, ja tas nebūs vajadzīgs. |
| Atcd | Automātiska telemārketinga zvanu noteikšana — funkcija, kas klausās automatizētus/robotizētus zvanus un pārtrauc savienojumu, ja šāds zvans tiek konstatēts. Iespējamās vērtības: 1 vai 0, noklusējums ir 0 |
| SID | Sub Account ID (apakškonta ID) – definējiet apakškontus šeit: https://www.multitel.net/auth/setting/ cilnē SubAccounts (apakškonti) |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... utt.
Lūdzu, ņemiet vērā, ka GET izmantotie parametri ir tieši tādi paši kā POST izmantotie parametri, un tie ir jāizmanto tieši tādā secībā, kādā tie ir norādīti
iepriekšējā tabula.
Mēs stingri iesakām izmantot POST, nevis GET, jo tas samazina parametru sajaukšanas risku.