See funktsioon võimaldab teil osta telefoninumbri.
Kui soovite hoida asjad lihtsana, piisab vaikimisi ringto URI (sissetuleva kõne sihtkoha) määratlemisest (https://www.multitel.net/auth/setting , vahekaardil "URI Settings (URI sätted)") ja seejärel alloleva URL-i kutsumisest:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Edukas API-kutse tagastab järgmise teate:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Ebaõnnestunud kõne tagastab ühe järgmistest teadetest:
{"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.Kui peate määrama rohkem parameetreid, lugege edasi:
POST URL: https://api.multitel.net/json/buynumbers/
POST-parameetrid:
| UserName | Teie sisselogimise kasutajanimi või teie API kasutajanimi |
| Password | Teie sisselogimisparool või teie API-parool |
| Number | Telefoninumber, mida soovite osta |
| Description | Lühikirjeldus (kui ei ole esitatud, kasutatakse vaikimisi Number) |
| Type | Vastab veebiliidese valikule „Forward Destination” (suunamise sihtkoht). Võimalikud väärtused on: 1 (SIP jaoks) või 2 (Dial jaoks) |
| RingType | 1 järjestikuse jaoks, 2 juhusliku jaoks, 3 samaaegse jaoks |
| Ringstyle | 1: Ring (helin), 2: Music (muusika, Early Media – heli enne kõnele vastamist) |
| URI | Esimene helisev SIP URI (või valitav telefoninumber -- palun ilma 00/011/+ prefiksita) |
| URI2 | Teine helisev SIP URI |
| URI3 | Kolmas SIP URI, millele helistada |
| SMSRingType | 1 e-posti jaoks, 2 POST-päringu saatmiseks URL-ile |
| SMSURI | kas e-posti aadress või POST-i URL |
| FaxDetect | 1 – lubatud, 0 – keelatud. Kui määramata, on vaikeväärtus 0 |
| FaxEmail | E-posti aadress, kuhu faks edasi saata |
| FaxRing | Mitu sekundit peaksime faksitoone kuulama? Vaikeväärtus on 5 |
| Vm | Kas häälpost on lubatud? Võimalikud väärtused 1 või 0 |
| Vmring | Mitu sekundit enne kõneposti (VM) rakendumist |
| Vms2t | Kõneposti kõne tekstiks (Speech 2 Text) -- 1 lubatud, 0 keelatud |
| Vmemail | E-posti aadress, kuhu kõnepostid edasi saata |
| Cnam | Lubage CNAM-päringud (võimalikud väärtused 0 või 1 – vaikimisi 0) |
| Record | Salvestage telefonikõned (0 või 1, vaikimisi 0) |
| Screening | Helistajate kontrollimine: paluge neil enne ühendamist end tutvustada. Võimalikud väärtused on 0 või 1, vaikeväärtus on 0. |
| Channels | Mitu kanalit vajame? Vaikimisi 2, kui numbril pole saadaval ainult 1 kanal. Pange tähele, et ainult SMS-i numbrite (numbrid, millel puudub VoIP-võimekus) puhul sellel sättel mõju puudub, seega ärge seda seadke, kui te seda ei vaja. |
| Atcd | Automaatse telemarketingukõne tuvastus -- funktsioon, mis kuulab automaatseid/robotkõnesid ja katkestab kõne, kui selline kõne tuvastatakse. Võimalikud väärtused 1 või 0, vaikimisi 0 |
| SID | Sub Account ID (alamkonto ID) – määrake alamkontod asukohas https://www.multitel.net/auth/setting/ vahekaardil SubAccounts (alamkontod) |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... jne
Pange tähele, et GET-meetodi puhul kasutatavad parameetrid on täpselt samad mis POST-meetodi puhul kasutatavad parameetrid ning neid tuleb kasutada täpselt samas järjekorras, nagu need on loetletud
ülaltoodud tabel.
Soovitame tungivalt kasutada GET-i asemel POST-i, kuna see minimeerib parameetrite segi ajamise riski.