更新 Microsoft Store 識別碼金鑰

  • 發行項

使用這個方法來更新 Microsoft Store 金鑰。 當您產生 Microsoft Store 識別碼金鑰時，金鑰的有效期限為 90 天。 金鑰過期之後，您可以使用過期的金鑰，透過此方法重新協商新的金鑰。

Microsoft.StoreServices 程式庫透過 UserStoreId.RefreshStoreId 提供此方法的功能。

必要條件

若要使用此方法，您將需要：

如需詳細資訊，請參閱從服務管理產品權利。

要求

要求語法

金鑰類型 方法 要求 URI
集合 POST https://collections.mp.microsoft.com/v6.0/b2b/keys/renew
購買 POST https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew

要求標頭

標題 類型 描述
Host string 必須設定為值 collections.mp.microsoft.com 或 purchase.mp.microsoft.com。
Content-Length 數值 要求本文的長度。
內容-類型 string 指定要求和回應類型。 目前唯一支援的值是 application/json。

要求本文

參數 類型 描述 必要
serviceTicket string Azure AD 存取權杖。 Yes
索引鍵 string 過期的 Microsoft Store 識別碼金鑰。 Yes

要求範例

POST https://collections.mp.microsoft.com/v6.0/b2b/keys/renew HTTP/1.1
Content-Length: 2774
Content-Type: application/json
Host: collections.mp.microsoft.com

{
    "serviceTicket": "eyJ0eXAiOiJKV1QiLCJhb….",
    "Key": "eyJ0eXAiOiJKV1QiLCJhbG…."
}

回應

回應本文

參數 類型 描述
索引鍵 string 重新整理的 Microsoft Store 金鑰，可在未來呼叫 Microsoft Store 集合 API 或購買 API 時使用。

回應範例

HTTP/1.1 200 OK
Content-Length: 1646
Content-Type: application/json
MS-CorrelationId: bfebe80c-ff89-4c4b-8897-67b45b916e47
MS-RequestId: 1b5fa630-d672-4971-b2c0-3713f4ea6c85
MS-CV: xu2HW6SrSkyfHyFh.0.0
MS-ServerId: 030011428
Date: Tue, 13 Sep 2015 07:31:12 GMT

{
    "key":"eyJ0eXAi….."
}

錯誤碼

代碼 錯誤 內部錯誤碼 描述
401 未經授權 AuthenticationTokenInvalid Azure AD 存取權杖無效。 在某些情況下，ServiceError 的詳細資料將包含詳細資訊，例如權杖過期或 appid 宣告遺失時。
401 未經授權 InconsistentClientId Microsoft Store 識別碼金鑰中的 clientId 宣告和 Azure AD 存取權杖中的 appid 宣告不相符。