续订 Microsoft Store ID 密钥

使用此方法续订 Microsoft Store 密钥。 生成 Microsoft Store ID 密钥时,该密钥在 90 天内有效。 在密钥过期后,你可以通过此方法使用已过期的密钥重新协商一个新密钥。

Microsoft.StoreServices 库通过 UserStoreId.RefreshStoreId API 提供此方法的功能。

先决条件

若要使用此方法,你需要:

有关详细信息,请参阅管理来自服务的产品授权

请求

请求语法

密钥类型 方法 请求 URI
集合 POST https://collections.mp.microsoft.com/v6.0/b2b/keys/renew
购买 POST https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew

请求头

标头 类型 说明
主机 string 必须设置为值 collections.mp.microsoft.compurchase.mp.microsoft.com
Content-Length 数值 请求正文的长度。
Content-Type 字符串 指定请求和响应类型。 当前,唯一受支持的值为 application/json

请求正文

参数 类型 说明 必须
serviceTicket string Azure AD 访问令牌。
key string 过期的 Microsoft Store ID 密钥。

请求示例

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…."
}

响应

响应正文

参数 类型 描述
key 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 ID 密钥中的 clientId 声明与 Azure AD 访问令牌中的 appid 声明不匹配。