更新 Microsoft Store 識別碼金鑰
使用這個方法來更新 Microsoft Store 金鑰。 當您產生 Microsoft Store 識別碼金鑰時,金鑰的有效期限為 90 天。 金鑰過期之後,您可以使用過期的金鑰,透過此方法重新協商新的金鑰。
Microsoft.StoreServices 程式庫透過 UserStoreId.RefreshStoreId 提供此方法的功能。
必要條件
若要使用此方法,您將需要:
- Azure AD 存取權杖,具有對象 URI 值
https://onestore.microsoft.com
。 - 從您應用程式中用戶端程式代碼產生的過期 Microsoft Store 識別碼金鑰。
如需詳細資訊,請參閱從服務管理產品權利。
要求
要求語法
金鑰類型 | 方法 | 要求 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 宣告不相符。 |
相關主題
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應