Ця функція дозволить вам придбати номер телефону.
Якщо ви хочете максимально просто, достатньо визначити URI дзвінка за замовчуванням (ringto URI) (https://www.multitel.net/auth/setting , на вкладці «Налаштування URI (URI Settings)») і потім викликати наведений нижче URL:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
Успішний виклик API поверне таке повідомлення:
{"DATA":[{"RETURN":1234567890}]} <= this is presuming you were trying to purchase phone number 1234567890Невдалий виклик поверне одне з таких повідомлень:
{"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.Якщо потрібно вказати більше параметрів, читайте далі:
POST URL: https://api.multitel.net/json/buynumbers/
Параметри POST:
| UserName | Ваше ім’я користувача для входу або ваше ім’я користувача API |
| Password | Ваш пароль для входу або ваш пароль API |
| Number | Номер телефону, який ви хочете придбати |
| Description | Короткий опис (якщо не вказано, за замовчуванням використовується Number) |
| Type | Еквівалент "Forward Destination" у вебінтерфейсі. Можливі значення: 1 (для SIP) або 2 (для Dial) |
| RingType | 1 – послідовно (Sequential), 2 – випадково (Random), 3 – одночасно (Simultaneous) |
| Ringstyle | 1 — сигнал виклику (Ring), 2 — музика (Music) до відповіді (Early Media) |
| URI | Перший SIP URI для виклику (або номер телефону для набору -- без префікса 00/011/+) |
| URI2 | Другий SIP URI для дзвінка |
| URI3 | Третій SIP URI для виклику |
| SMSRingType | 1 — для електронної пошти, 2 — для POST-запиту на URL-адресу |
| SMSURI | або адреса E-Mail, або URL-адреса для POST |
| FaxDetect | 1 - увімкнено, 0 - вимкнено. Якщо не вказано, за замовчуванням 0 |
| FaxEmail | Адреса електронної пошти, на яку пересилати факс |
| FaxRing | Скільки секунд слід прослуховувати тональні сигнали факсу? За замовчуванням — 5 |
| Vm | Голосову пошту ввімкнено? Можливі значення 1 або 0 |
| Vmring | Через скільки секунд вмикається голосова пошта (VM) |
| Vms2t | Перетворення голосової пошти на текст (Voicemail Speech 2 Text) -- 1 — увімкнено, 0 — вимкнено |
| Vmemail | Адреса електронної пошти для пересилання голосових повідомлень |
| Cnam | Увімкніть пошук CNAM (можливі значення 0 або 1 — за замовчуванням 0) |
| Record | Записувати телефонні розмови (0 або 1, за замовчуванням 0) |
| Screening | Перевірка абонентів, що телефонують (попросити їх назватися перед з’єднанням — можливі значення 0 або 1, за замовчуванням 0 |
| Channels | Скільки каналів нам потрібно? За замовчуванням 2, крім випадку, коли для номера доступний лише 1 канал. Зверніть увагу: для номерів лише для SMS (номерів без можливостей VoIP) це налаштування не має впливу, тому не встановлюйте його, якщо воно вам не потрібне. |
| Atcd | Автоматичне виявлення телемаркетингових дзвінків (Automatic Telemarketer Call Detection) -- функція, що прослуховує автоматизовані дзвінки/рободзвінки і завершує виклик, якщо такий дзвінок виявлено . Можливі значення 1 або 0 , за замовчуванням 0 |
| SID | Ідентифікатор субакаунта (Sub Account ID) — визначте свої субакаунти в https://www.multitel.net/auth/setting/ на вкладці «Субакаунти» (SubAccounts) |
GET URL:
https://api.multitel.net/json/buynumbers/UserName/Password/Number/Description/Type/RingType/Ringstyle/URI/URI2/URI3/SMSRingType/ .... тощо
Зверніть увагу, що параметри, які використовуються для GET, точно такі самі, як параметри, що використовуються для POST, і їх слід використовувати точно в тому порядку, в якому вони перелічені в
таблиця вище.
Наполегливо рекомендуємо використовувати POST замість GET, оскільки це мінімізує ризик переплутати параметри.