Используйте HTTPS и аутентификацию HTTP Basic с одобренными учетными данными API. Храните учетные данные на сервере приложений. Эти конечные точки Hosted PBX используют /hpbx/ на api.multitel.net; не вставляйте /v3. Проверяйте как результат HTTP, так и статус приложения в ответе JSON.
Список экземпляров PBX в учётной записи
curl --request POST --user "USERNAME:PASSWORD" \
"https://api.multitel.net/hpbx/tenants/list/0"Операция получения списка возвращает среды PBX (tenants) аутентифицированной учётной записи. Последний сегмент-заполнитель нужен для соответствия сигнатуре маршрута; операция получения списка не использует его для выбора другой учётной записи.
Пример ответа со списком
{
"status": {
"code": "200",
"msg": "List data"
},
"response": [
{
"billing_code": "EXAMPLE_BILLING_CODE",
"isocode": "US",
"continent_iso": "NA",
"continent_name": "North America"
}
]
}Создание и изменение отдельной клиентской среды PBX (тенанта)
Создание отдельного клиентского окружения PBX (tenant) является действием по оформлению подписки и может привести к плате за подключение и периодическим платежам. Сначала ознакомьтесь с доступными тарифными планами. Используйте актуальную справочную документацию, доступную в рамках прав вашей учетной записи, чтобы выбрать план, местоположение и профиль маршрутизации; не используйте идентификатор из примера в качестве выбора для своей учетной записи.
| Поле создания | Значение |
|---|---|
| hosted_pbx_services_id | Идентификатор сервиса, возвращаемый для доступного тарифного плана. |
| te_rp_id | Утвержденный профиль маршрутизации вызовов. |
| timezone | Часовой пояс IANA, например America/Detroit. |
| te_location_id | Идентификатор местоположения, доступный для учётной записи, если он требуется. |
| te_maxextensions / te_maxhunts / te_maxconferences / te_maxvoicemails / te_maxivrs | Доступные объёмы ресурсов ограничены выбранной услугой; эти параметры не позволяют произвольно переопределять предоставленные права. |
Проверьте полученный биллинг-код и статус подключения (provisioned) перед настройкой добавочных номеров. Для новых интеграций и точных схем запросов на изменение используйте актуальный справочник по подпискам.