Эта функция позволит вам приобрести телефонный номер.
Если вы предпочитаете простоту, достаточно определить URI ringto по умолчанию (https://www.multitel.net/auth/setting , на вкладке «Настройки URI (URI Settings)») и затем вызвать указанный ниже URL:
https://api.multitel.net/json/buynumbers/USERNAME/PASSWORD/NUMBER
При успешном вызове будет возвращено следующее сообщение:
{"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 | либо адрес электронной почты, либо POST URL |
| 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, так как это снижает риск перепутать параметры.