與 Azure 通訊閘道的布建 API 整合 （預覽版）
本文說明何時需要與 Azure 通訊閘道的布建 API 整合（預覽版），並提供入門的高階概觀。 它適用於為電信運營商工作的軟體開發人員。
布建 API 可讓您設定 Azure 通訊閘道，其中包含客戶的詳細數據，以及您已指派給他們的數位。 如果您使用布建 API 進行後端服務同步處理，您也可以布建 電信業者連線 和 Teams 電話 行動裝置環境，其中包含企業客戶的詳細數據，以及您為其配置的數位。 此流程布建可讓您符合 電信業者連線 和 Teams 電話 行動裝置需求，以在啟動服務之後使用 API 來管理您的客戶和號碼。
布建 API 是 REST API。
您是否要與布建 API 整合，取決於您選擇的通訊服務。
| 通訊服務 | 布建 API 整合 | 目的 |
|---|---|---|
| Microsoft Teams 直接路由 | 支援 （作為號碼管理入口網站的替代方案） | - 設定與每個直接路由客戶相關聯的子域。 - 產生每位客戶專屬的 DNS 記錄（Microsoft 365 環境需要）。 - 表示已啟用直接路由的數位。 - （選擇性） 設定網路訊息的自定義標頭。 |
| 操作員連線 | 建議需求 | - （建議） 透過與 電信業者連線 API 互通（使用後端服務同步）來布建 電信業者連線 客戶的流程。 - （選擇性） 設定網路訊息的自定義標頭。 |
| Teams 電話行動版 | 建議需求 | - -（建議）透過與 電信業者連線 API 互通（使用後端服務同步）來布建 Teams 電話 行動版客戶。 |
| 縮放 電話 雲端對等互連 | 支援 （作為號碼管理入口網站的替代方案） | - 表示已啟用 Zoom 的數位。 - （選擇性） 設定網路訊息的自定義標頭。 |
| Azure 操作員通話保護預覽 | 支援 （作為號碼管理入口網站的替代方案） | - 指出已啟用 Azure 操作員通話保護的數位。 - 自動布建 Azure 操作員通話保護。 |
提示
Azure 通訊閘道的號碼管理入口網站提供手動布建的對等功能。 不過，在啟動服務之後，您無法使用號碼管理入口網站來徹底布建 電信業者連線 和 Teams 電話 Mobile。
必要條件
您必須已完成 部署 Azure 通訊閘道。
您必須具有允許存取布建 API 之 IP 位址的電腦存取權（預覽版）。 此IP位址（或範圍）允許清單已設定為部署 Azure 通訊閘道的一部分。
瞭解布建 API （預覽） 並規劃 BSS 用戶端變更
若要與 API 整合，您必須建立 BSS 用戶端，以連絡布建 API。 布建 API 支援電腦對機器 OAuth 2.0 用戶端認證驗證流程。 您的用戶端會自行驗證並進行授權的 API 呼叫，而不會與用戶互動。
使用 API 參考中的重要概念和範例資訊，瞭解 API 上可用的資源，以及貴組織需要提出的要求。
- 帳戶 資源是操作員客戶的描述（通常是企業），以及服務布建的每個客戶設定。
- 數字 資源屬於帳戶。 他們會描述數位、數位所使用的服務（例如 Microsoft Teams 直接路由），以及任何額外的個別號碼組態。
- 資訊要求 （RFI） 資源是操作員客戶（通常是企業）的描述，他們表示有興趣透過 電信業者連線和 Teams 電話 Mobile 從操作員接收服務。
佈建 API 的速率限制為每分鐘 100 個要求，適用於所有資源。 更新多個資源的批次要求會計為一個要求。
設定 BSS 用戶端以連線到 Azure 通訊閘道
布建 API （預覽） 可在 的 provapi.<base-domain>埠 443 上使用，其中 <base-domain> 是 Azure 通訊網關資源的基域。
提示
若要尋找基底網域：
- 登入 Azure 入口網站。
- 流覽至 Azure 通訊閘道資源的概觀 ，然後選取 [ 屬性]。
- 尋找名為 Domain 的欄位。
DNS 記錄的存留時間為 60 秒。 當區域失敗時，Azure 會更新 DNS 記錄以參考另一個區域，因此進行新 DNS 查閱的用戶端會收到新區域的詳細數據。 我們建議確保用戶端可以在逾時或 5xx 回應之後，進行新的 DNS 查閱，然後重試要求 60 秒。
使用 API 參考的開始使用區段來設定 Azure 和 BSS 用戶端，以允許 BSS 用戶端存取布建 API。
下列步驟摘要說明您需要的 Azure 設定。 如需完整詳細數據，請參閱 API 參考的快速入門一節，包括必要的組態值。
- 在與 Azure 通訊閘道部署相同的 Azure 租用戶中註冊 BSS 用戶端。 此程式會建立應用程式註冊。
- 將自己指派為應用程式註冊的擁有者。
- 使用 API 參考中定義的範圍來設定應用程式註冊。 此組態會向 Azure 指出您的應用程式允許存取布建 API。
- 身為租用戶的系統管理員，允許應用程式使用您指派的應用程式角色。