本文介绍何时需要与 Azure 通信网关的预配 API（预览版）集成，并提供入门的高级概述。 它适用于为电信运营商工作的软件开发人员。
预配 API 允许你配置 Azure 通信网关，其中包含客户的详细信息以及已分配给他们的号码。 如果使用配置 API 进行 后端服务同步，还可以使用您的企业客户的信息以及分配给他们的号码来配置操作员连接和 Teams Phone Mobile 环境。 通过此直通式配置，您可以满足 Operator Connect 和 Teams 手机服务的要求，在启动服务后使用 API 来管理客户和号码。
预配 API 是 REST API。
是否与预配 API 集成取决于所选的通信服务。
| 通信服务 | 预配 API 集成 | 目的 |
|---|---|---|
| Microsoft Teams 直接路由 | 支持（作为号码管理门户的替代方法） | - 配置与每个直接路由客户关联的子域。 - 生成特定于每个客户的 DNS 记录（Microsoft 365 环境需要）。 - 指示启用直接路由的号码。 - （可选）为网络的消息配置自定义标头。 |
| 运营商连接 | Recommended | （建议）通过与运营商连接 API 互操作（使用后端服务同步）来顺畅预配运营商连接客户。 - （可选）为发送到网络的消息配置自定义标头。 |
| Teams 手机移动版 | Recommended | - （推荐）通过与操作员连接 API（使用后端服务同步）进行互操作来实现 Teams Phone Mobile 客户的实时预配。 |
| Zoom Phone 云对接 | 支持（作为数字管理门户的替代方案） | - 指示为 Zoom 启用数字。 - （可选）为发送至网络的消息配置自定义标题。 |
小窍门
Azure 通信网关的号码管理门户提供手动预配所需的等效功能。 但是，启动服务后，不能使用号码管理门户进行操作员连接和 Teams Phone Mobile 的端到端预配。
先决条件
必须已完成 部署 Azure 通信网关。
您必须能够访问具有获准访问 Provisioning API（预览版）的 IP 地址的计算机。 此 IP 地址允许名单（或范围）是 部署 Azure 通信网关的一部分配置。
了解预配 API（预览版）并规划 BSS 客户端更改
若要与 API 集成，需要创建可以联系预配 API 的 BSS 客户端（或更新）。 预配 API 支持机器对机器 OAuth 2.0 客户端凭据认证流程。 客户端在无需用户交互的情况下自行进行身份验证并发出经过授权的 API 调用。
使用 API 参考中的关键概念和示例信息，了解通过 API 提供的资源以及组织需要发出的请求。
- 帐户 资源是运营商客户（通常为企业）的描述，以及用于服务预配的每个客户设置。
- 编号 资源属于帐户。 它描述了号码、号码所使用的服务（例如，Microsoft Teams 的直接路由），以及每个号码的任何额外配置。
- 信息请求（RFI） 资源指的是运营商客户（通常是企业），他们对通过 Operator Connect 和 Teams Phone Mobile 从运营商处接收服务表示了兴趣。
预配 API 的速率限制为每分钟 100 个请求，并在所有资源中使用。 用于更新多个资源的批处理请求计数为一个请求。
将 BSS 客户端配置为连接到 Azure 通信网关
预配 API（预览版）在端口 443 provapi.<base-domain>上提供，其中 <base-domain> 是 Azure 通信网关资源的基域。
小窍门
若要查找基本域，请执行以下命令：
- 登录到 Azure 门户。
- 导航到 Azure 通信网关资源的 概述 ，然后选择 “属性”。
- 查找名为 “域”的字段。
DNS 记录的生存时间 （TTL） 为 60 秒。 当某个区域发生故障时，Azure 会更新 DNS 记录以引用另一个区域，因此发出新的 DNS 查找的客户端将收到新区域的详细信息。 建议确保客户端可以在超时或 5xx 响应后 60 秒重试请求，并进行新的 DNS 查找。
使用 API 参考的“入门”部分来配置 Azure 和 BSS 客户端，以允许 BSS 客户端访问预配 API。
以下步骤汇总了所需的 Azure 配置。 有关完整详细信息，请参阅 API 参考的“入门”部分，包括所需的配置值。
- 在 Azure 通信网关部署所在的同一 Azure 租户中注册 BSS 客户端。 此过程将创建应用注册。
- 将自己分配为应用注册的所有者。
- 使用 API 参考中定义的作用域配置应用注册。 此配置向 Azure 指示允许应用程序访问预配 API。
- 作为租户的管理员，允许应用程序使用你分配的应用角色。