在合作夥伴中心設置 API 訪問

適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府Microsoft雲端合作夥伴中心

本文介紹需要針對合作夥伴中心 SDK 開發的帳戶。 本文還介紹了如何創建 集成沙盒帳戶 並在集成沙盒中進行測試。

了解帳戶定義

為了説明你集成和測試 API 集成，合作夥伴中心支援兩種類型的帳戶。

主要合作夥伴帳戶

此帳戶是您為真實客戶創建真實訂單的地方。 如果您在登錄主帳戶時通過使用合作夥伴中心 SDK 或合作夥伴控制面板 UI 進行了任何更改或交易，則這些更改或交易將被視為真實客戶的正式訂單。 它們會反映在您的發票中，您的公司負責支付這些費用。

集成沙盒帳戶

此帳戶用於在廣泛部署代碼之前測試代碼及其與合作夥伴中心 API 的集成。 您在登錄集成沙盒帳戶時所做的更改和交易將顯示在您的發票中，但您不必支付發票金額。 發票 pdf 包含免責聲明：「不要付款。 這是沙盒發票，無需執行任何作。

• 集成沙盒帳戶和主帳戶獨立運行。 他們不共用管理員帳戶、用戶帳戶、客戶、訂單、訂閱或其他數據。
• 集成沙盒支援具有有限數量的客戶、訂單、訂閱、許可證等的交易。
• 集成沙盒帳戶僅按策略用於集成測試目的。
• 默認情況下，不存在集成沙盒帳戶。 如果您計劃使用合作夥伴中心 SDK，則必須自行創建一個。

設置您的帳戶

本節介紹如何為合作夥伴中心 SDK 設置主要合作夥伴帳戶和集成沙盒帳戶。

創建集成沙盒

要創建集成沙盒，請按照 創建雲解決方案供應商 （CSP） 集成沙盒帳戶中的步驟作。

啟用 API 存取

設置帳戶后，必須先啟用 API 訪問，然後才能將合作夥伴中心 SDK 與集成沙盒一起使用。 您需要為主合作夥伴帳戶和整合沙盒帳戶分別啟用對 API 的訪問。

1. 使用全域管理員帳戶登錄到 合作夥伴中心 ，然後選擇 「設置 」 （齒輪圖示） 。
2. 選擇 Account settings（帳戶設置），然後選擇 App management（應用程式管理）。
3. 如果您還沒有現有應用程式，請添加新的 Web 應用程式。 如果您有現有的 Web 應用程式，請選擇 Add key （添加金鑰 ） 按鈕。
4. 複製應用程式註冊資訊，尤其是 Key （如果要創建 Web 應用程式），並將其存儲在安全的位置。
5. 註銷 Partner Dashboard。
6. 使用集成沙盒帳戶重新登錄。 重複步驟 2-5 以在集成沙箱中啟用 API 訪問。

編寫和測試代碼

您可以在整合沙箱中編寫代碼和測試代碼。 需要以下資訊才能使用 Microsoft Entra ID 設置合作夥伴中心身份驗證 。

• 應用程式 ID / 用戶端 ID：在設置（齒輪圖示）帳戶設置應用程式>管理>中列為註冊的應用程式應用程式 ID。
• 金鑰：如果您在 上一節中創建了新的 Web 應用程式，請使用該金鑰。
• 域：用於集成沙盒。

運行經過測試的代碼

要將解決方案與真實客戶數據一起使用，您必須從集成沙盒憑證更改為主合作夥伴帳戶憑證。

當您準備好在主要合作夥伴帳戶中使用經過測試的代碼時，您需要 Microsoft Entra 安全令牌。 此安全權杖以合作夥伴 中心 應用、金鑰和網域 （而不是 整合沙箱 應用、金鑰和域 ） 。

1. 按照 合作夥伴中心身份驗證 中的步驟，使用主要合作夥伴中心憑據獲取 Microsoft Entra 安全令牌。 （您之前已按照以下步驟獲取集成沙盒的 Microsoft Entra 安全令牌。
2. 將代碼中的集成安全令牌替換為主合作夥伴帳戶的新安全令牌。

相關內容

• 合作夥伴中心開發人員文件
• 合作夥伴中心 API 入門
• 合作夥伴中心 API 示例