Tato funkce vám umožní zakoupit telefonní číslo.
Pokud chcete vše udržet jednoduché, stačí definovat výchozí URI ringto (cíl příchozího hovoru) (https://www.multitel.net/auth/setting , na kartě „URI Settings“ (nastavení URI)) a poté zavolat níže uvedenou adresu URL:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Úspěšné volání API vrátí následující zprávu:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Neúspěšný hovor vrátí jednu z následujících zpráv:
{"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.Pokud potřebujete zadat další parametry, čtěte dál:
POST URL: https://api.multitel.net/json/buynumbers/
Parametry POST:
| UserName | Vaše přihlašovací uživatelské jméno nebo vaše uživatelské jméno API |
| Password | Vaše přihlašovací heslo nebo vaše heslo API |
| Number | Telefonní číslo, které chcete zakoupit |
| Description | Krátký popis (pokud není zadán, výchozí je Number) |
| Type | Odpovídá položce „Forward Destination“ (cíl přesměrování) z webového rozhraní. Možné hodnoty jsou: 1 (pro SIP) nebo 2 (pro Dial – vytáčení) |
| RingType | 1 pro sekvenční, 2 pro náhodné, 3 pro simultánní |
| Ringstyle | 1 pro Ring (vyzvánění), 2 pro Music (hudba, Early Media – zvuk před spojením hovoru) |
| URI | První SIP URI k vyzvánění (nebo telefonní číslo k vytočení – prosím bez předvolby 00/011/+) |
| URI2 | Druhé URI SIP pro vyzvánění |
| URI3 | Třetí SIP URI, na které se má zvonit |
| SMSRingType | 1 pro e-mail, 2 pro odeslání metodou POST na URL |
| SMSURI | buď e-mailová adresa, nebo adresa URL pro POST |
| FaxDetect | 1 pro zapnuto, 0 pro vypnuto. Pokud není zadáno, výchozí hodnota je 0 |
| FaxEmail | E-mail pro přeposílání faxu |
| FaxRing | Kolik sekund máme naslouchat faxovým tónům? Výchozí hodnota je 5 |
| Vm | Je hlasová schránka povolena? Možné hodnoty 1 nebo 0 |
| Vmring | Počet sekund před aktivací hlasové schránky |
| Vms2t | Přepis hlasové schránky (Speech 2 Text) – 1 pro zapnuto, 0 pro vypnuto |
| Vmemail | E-mailová adresa, na kterou se mají přeposílat hlasové zprávy |
| Cnam | Povolit vyhledávání CNAM (možné hodnoty 0 nebo 1 – výchozí je 0) |
| Record | Nahrávat telefonní hovory (0 nebo 1, výchozí hodnota je 0) |
| Screening | Prověřovat volající: před spojením je požádat, aby se představili. Možné hodnoty jsou 0 nebo 1, výchozí hodnota je 0. |
| Channels | Kolik kanálů potřebujeme? Výchozí hodnota je 2, pokud číslo nemá k dispozici pouze 1 kanál. Upozorňujeme, že u čísel pouze pro SMS (čísla bez možnosti VoIP) nemá toto nastavení žádný účinek, takže jej nenastavujte, pokud jej nebudete potřebovat. |
| Atcd | Automatická detekce telemarketingových hovorů – funkce, která naslouchá automatizovaným/robotickým hovorům a zavěsí, pokud je takový hovor zjištěn. Možné hodnoty 1 nebo 0, výchozí hodnota je 0 |
| SID | Sub Account ID (ID podúčtu) – podúčty nastavte na https://www.multitel.net/auth/setting/ na kartě SubAccounts (podúčty) |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... atd.
Upozorňujeme, že parametry použité pro GET jsou přesně stejné jako parametry použité pro POST a měly by být použity přesně v pořadí, v jakém jsou uvedeny v
tabulka výše.
Důrazně doporučujeme používat POST místo GET, protože se tím minimalizuje riziko prohození parametrů.