Интеграция с API подготовки шлюза коммуникаций Azure (предварительная версия)
В этой статье объясняется, когда необходимо интегрироваться с API подготовки шлюза коммуникации Azure (предварительная версия) и предоставляет общие сведения о начале работы. Это для разработчиков программного обеспечения, работающих для операторов телекоммуникаций.
API подготовки позволяет настроить шлюз коммуникаций Azure с подробными сведениями о клиентах и номерах, назначенных им. Если вы используете API подготовки для синхронизации серверной службы, вы также можете подготовить среды Operator Connect и Teams Phone Mobile с подробными сведениями о ваших корпоративных клиентах и номерах, выделенных для них. Эта потоковая подготовка позволяет выполнять требования оператора Connect и Teams Phone Mobile для управления клиентами и номерами после запуска службы.
API подготовки — это REST API.
Интеграция с API подготовки зависит от выбранной службы коммуникации.
| Служба коммуникаций | Интеграция API подготовки | Характер использования |
|---|---|---|
| Прямая маршрутизация Microsoft Teams | Поддерживается (в качестве альтернативы порталу управления номерами) | — настройка поддомена, связанного с каждым клиентом прямой маршрутизации. — создание записей DNS, относящихся к каждому клиенту (в соответствии с требованиями среды Microsoft 365). — указывает, что номера включены для прямой маршрутизации. — (Необязательно) Настройка пользовательского заголовка для сообщений в сети. |
| Operator Connect | Рекомендуемая конфигурация | — Рекомендуется выполнять потоковую подготовку клиентов операторов через взаимодействие с API-интерфейсами Operator Connect (с помощью синхронизации серверной службы). — (Необязательно) Настройка пользовательского заголовка для сообщений в сети. |
| Teams Phone Mobile | Рекомендуемая конфигурация | — Рекомендуется выполнять потоковую подготовку клиентов Teams Phone Mobile через взаимодействие с API-интерфейсами Operator Connect (с помощью синхронизации серверной службы). |
| Пиринг в облаке масштабирования телефонов | Поддерживается (в качестве альтернативы порталу управления номерами) | — указывает, что для масштабирования включены числа. — (Необязательно) Настройка пользовательского заголовка для сообщений в сети. |
Совет
Портал управления номерами шлюза коммуникации Azure предоставляет эквивалентную функцию для подготовки вручную. Однако вы не можете использовать портал управления номерами для тщательной подготовки оператора Connect и Teams Phone Mobile после запуска службы.
Необходимые компоненты
Необходимо завершить развертывание шлюза коммуникаций Azure.
У вас должен быть доступ к компьютеру с IP-адресом, разрешенным для доступа к API подготовки (предварительная версия). Этот список разрешенных IP-адресов (или диапазонов) был настроен в рамках развертывания шлюза коммуникаций Azure.
Сведения об API подготовки (предварительная версия) и планирование изменений клиента BSS
Чтобы интегрироваться с API, необходимо создать (или обновить) клиент BSS, который может связаться с API подготовки. API подготовки поддерживает поток проверки подлинности учетных данных клиента OAuth 2.0 на компьютере. Клиент выполняет проверку подлинности и выполняет авторизованные вызовы API без взаимодействия пользователей.
Используйте основные понятия и примеры в справочнике по API, чтобы узнать о ресурсах, доступных через API, и запросах, необходимых вашей организации.
- Ресурсы учетной записи — это описания клиентов-операторов (как правило, предприятия) и параметров каждого клиента для подготовки служб.
- Число ресурсов принадлежит учетной записи. Они описывают числа, службы, которые используют номера (например, Прямая маршрутизация Microsoft Teams) и любую дополнительную конфигурацию для каждого числа.
- Ресурсы запроса на получение информации (RFI) — это описания клиентов операторов (как правило, предприятия), которые выразили интерес к получению услуги от оператора через Оператор Connect и Teams Phone Mobile.
API подготовки имеет ограничение скорости в 100 запросов в минуту, примененных ко всем ресурсам. Пакетный запрос для обновления нескольких ресурсов считается одним запросом.
Настройка клиента BSS для подключения к шлюзу коммуникаций Azure
API подготовки (предварительная версия) доступен через порт 443 provapi.<base-domain>, где <base-domain> находится базовый домен ресурса шлюза коммуникации Azure.
Совет
Чтобы найти базовый домен, выполните следующие действия.
- Войдите на портал Azure.
- Перейдите к обзору ресурса шлюза коммуникации Azure и выберите "Свойства".
- Найдите поле с именем Домен.
Запись DNS имеет время жизни (TTL) в 60 секунд. Если регион завершается ошибкой, Azure обновляет запись DNS для ссылки на другой регион, поэтому клиенты, создающие новую подстановку DNS, получают сведения о новом регионе. Мы рекомендуем убедиться, что клиенты могут выполнять новый поиск DNS и повторить запрос через 60 секунд после истечения времени ожидания или ответа 5xxx.
Используйте раздел "Начало работы" справочника по API для настройки Azure и клиента BSS, чтобы разрешить клиенту BSS доступ к API подготовки.
Ниже приведены сведения о нужной конфигурации Azure. Дополнительные сведения см. в разделе "Начало работы" в справочнике по API, включая необходимые значения конфигурации.
- Зарегистрируйте клиент BSS в том же клиенте Azure, что и развертывание шлюза коммуникации Azure. Этот процесс создает регистрацию приложения.
- Назначьте себя владельцем для регистрации приложения.
- Настройте регистрацию приложения с областями, определенными в справочнике по API. Эта конфигурация указывает Azure, что ваше приложение может получить доступ к API подготовки.
- Администратор клиента позволяет приложению использовать назначенные роли приложения.