共用方式為

硬體儀錶板 API

  • 發行項

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

  1. 這些 API 只能由屬於硬體 合作夥伴中心計劃的帳戶使用。

  2. 請確定您已完成下列必要條件。

  3. 在Microsoft硬體 API 中呼叫方法之前，請先取得Microsoft Entra ID 存取令牌，如下所示。 取得權杖之後，您有 60 分鐘的時間使用此權杖來呼叫 Microsoft Store 提交 API，之後權杖才會到期。 權杖過期後，您可以生成新的權杖。

  4. 呼叫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 硬體 API，以及Microsoft Surface和裝置小組所建立的完整端對端預先建置解決方案：

其他說明

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