Ez a függvény lehetővé teszi telefonszám vásárlását.
Ha szeretné egyszerűen tartani a dolgokat, csak meg kell határoznia egy alapértelmezett ringto URI-t (bejövő hívási célcímet) (https://www.multitel.net/auth/setting , az „URI Settings (URI-beállítások)” lapon), majd meg kell hívnia az alábbi URL-t:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Sikeres API-hívás esetén a következő üzenet érkezik vissza:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890A sikertelen API-hívás az alábbi üzenetek egyikét adja vissza:
{"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.Ha további paramétereket kell megadnia, olvasson tovább:
POST URL: https://api.multitel.net/json/buynumbers/
POST-paraméterek:
| UserName | Az Ön bejelentkezési felhasználóneve vagy az API-felhasználóneve |
| Password | A bejelentkezési jelszava vagy az API-jelszava |
| Number | A megvásárolni kívánt telefonszám |
| Description | Rövid leírás (ha nincs megadva, alapértelmezésként a Number mező értékét használja) |
| Type | Megfelel a webes felület „Továbbítási cél” (Forward Destination) beállításának. Lehetséges értékek: 1 (SIP esetén) vagy 2 (Dial esetén) |
| RingType | 1 Sorrendi (Sequential), 2 Véletlenszerű (Random), 3 Egyidejű (Simultaneous) |
| Ringstyle | 1 a csengetéshez, 2 a zenéhez (Early Media – kapcsolás előtti hang) |
| URI | Az első csengetendő SIP URI (vagy tárcsázandó telefonszám -- kérjük, 00/011/+ előtag nélkül) |
| URI2 | Második csengetendő SIP URI |
| URI3 | Harmadik kicsengetendő SIP URI |
| SMSRingType | 1 e-mailhez, 2 URL-re küldött POST-kéréshez |
| SMSURI | vagy e-mail-cím, vagy a POST url |
| FaxDetect | 1 = engedélyezve, 0 = letiltva. Ha nincs megadva, az alapértelmezett érték 0 |
| FaxEmail | E-mail-cím, ahová a faxot továbbítani kell |
| FaxRing | Hány másodpercig figyeljünk faxhangokra? Alapértelmezés: 5 |
| Vm | Hangposta engedélyezve? Lehetséges értékek: 1 vagy 0 |
| Vmring | Hány másodperc múlva kapcsol be a hangposta (VM) |
| Vms2t | Hangposta beszédének szöveggé alakítása (Speech 2 Text) -- 1 engedélyezve, 0 letiltva |
| Vmemail | E-mail-cím, ahová a hangpostákat továbbítani kell |
| Cnam | CNAM-lekérdezések engedélyezése (lehetséges értékek: 0 vagy 1 – alapértelmezés: 0) |
| Record | Telefonbeszélgetések rögzítése (0 vagy 1, alapértelmezés: 0) |
| Screening | Hívók szűrése (megkéri őket, hogy a kapcsolás előtt azonosítsák magukat – lehetséges értékek: 0 vagy 1, alapértelmezés: 0) |
| Channels | Hány csatornára van szükségünk? Alapértelmezés szerint 2, kivéve, ha a számhoz csak 1 csatorna érhető el. Felhívjuk figyelmét, hogy csak SMS-re alkalmas számoknál (VoIP-képesség nélküli számok) ennek a beállításnak nincs hatása, ezért ne állítsa be, ha nincs rá szüksége. |
| Atcd | Automatikus telemarketinghívás-felismerés -- olyan funkció, amely figyeli az automatizált/robothívásokat, és bontja a hívást, ha ilyet észlel. Lehetséges értékek: 1 vagy 0, alapértelmezés: 0 |
| SID | Sub Account ID (alfiók-azonosító) – az alfiókokat a https://www.multitel.net/auth/setting/ oldalon, a SubAccounts lapon adhatja meg |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... stb.
Kérjük, vegye figyelembe, hogy a GET-hez használt paraméterek pontosan megegyeznek a POST-hoz használt paraméterekkel, és pontosan abban a sorrendben kell használni őket, ahogyan fel vannak sorolva:
a fenti táblázat.
Nyomatékosan javasoljuk, hogy GET helyett POST-ot használjon, mivel ez minimalizálja a paraméterek felcserélésének kockázatát.