共用方式為

硬體儀錶板 API

  • 發行項

使用Microsoft硬體 API，以程式設計方式查詢並建立組織合作夥伴中心帳戶內硬體產品的提交。 如果您的帳戶管理許多產品，而且您想要將這些資產的提交程式自動化並優化，這些 API 會很有用。 這些 API 會使用 Microsoft Entra ID（Microsoft Entra ID）來驗證來自您應用程式或服務的呼叫。

只有屬於 硬體合作夥伴中心計劃的帳戶 才能使用硬體儀錶板 API。 使用 Microsoft 硬體 API 的端到端流程：

  1. 在下一節中完成必要條件。

  2. 在呼叫 Microsoft 硬體 API 中的方法之前，先取得 Microsoft Entra ID 的存取權杖。 取得令牌之後，您有 60 分鐘的時間，即可在令牌到期之前，在呼叫 Microsoft Store 提交 API 時使用它。 令牌到期之後，您可以產生新的令牌。

  3. 呼叫Microsoft硬體 API。

完成使用 Microsoft 硬體 API 的必要條件

開始撰寫程式代碼以呼叫 Microsoft 硬體 API 之前，您必須先完成下列必要條件：

將適當的硬體角色指派給Microsoft Entra ID 應用程式

完成必要條件之後，請指派適當的角色，讓Microsoft Entra ID 應用程式可以建立和管理提交和寄送卷標。

  1. 從合作夥伴中心選取齒輪圖示（靠近儀錶板右上角），然後選取 [ 開發人員設定]。 在 [設定] 選單中，選取 [使用者]。

  2. 在 [使用者] 頁面上，選取 [Microsoft Entra ID 應用程式，以及代表您用來存取合作夥伴中心帳戶提交之應用程式或服務的 Microsoft Entra ID 應用程式。

  3. 在此頁面的 [角色] 底下，選取 [硬體]。

    顯示 [角色] 區段中 [硬體] 標籤的螢幕快照。

    選取 [驅動程式提交者]、[出貨卷標擁有者]，如果有的話，則選取 [出貨卷標] 升級程式。 深入了解這些角色

取得Microsoft項目標識碼存取令牌

在Microsoft硬體 API 中呼叫任何方法之前，您必須先取得傳遞至 API 中每個方法授權標頭的 Microsoft Entra ID 存取令牌。 取得存取權杖之後，您在其到期之前有 60 分鐘的時間可以使用。 令牌到期之後，您可以重新整理令牌，以便繼續在 API 的進一步呼叫中使用。 若要取得存取令牌，請遵循使用用戶端認證進行服務對服務呼叫中的指示將 HTTP POST 傳送至 https://login.microsoftonline.com/<tenant_id>/oauth2/token 端點。 以下是範例要求。

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://manage.devcenter.microsoft.com

在 POST URI 中的 tenant_id 值，以及 client_id 和 client_secret 參數中，指定您在上一節中從合作夥伴中心擷取的應用程式的租用戶識別碼、用戶端識別碼及密鑰。 針對 resource 參數，您必須指定 https://manage.devcenter.microsoft.com。

存取令牌到期之後，您可以依照重新整理存取令牌中的 指示來重新整理令牌。

使用 Microsoft 硬體 API

Microsoft Entra ID 存取令牌之後，您可以在 Microsoft 硬體 API 中呼叫方法。 API 包含許多分組至案例的方法。 若要建立或更新提交，您通常會依特定順序呼叫Microsoft硬體 API 中的多個方法。 如需每個案例和每個方法語法的相關資訊，請參閱下表中的文章。

案例 描述
驅動程式 取得、建立及更新註冊至合作夥伴中心帳戶的驅動程式。 如需這些方法的詳細資訊，請參閱下列文章：

程式代碼範例

下列程式代碼範例提供由 Microsoft Surface 和 Devices 小組建立的完整端對端預先建置解決方案：

更多幫助

如果您有關於Microsoft市集提交 API 的問題，或需要使用此 API 管理提交的說明，請造訪 支援頁面 並要求說明。