续订 Microsoft Store ID 密钥
使用此方法续订 Microsoft Store 密钥。 生成 Microsoft Store ID 密钥时,该密钥在 90 天内有效。 在密钥过期后,你可以通过此方法使用已过期的密钥重新协商一个新密钥。
Microsoft.StoreServices 库通过 UserStoreId.RefreshStoreId API 提供此方法的功能。
先决条件
若要使用此方法,你需要:
- 受众 URI 值为
https://onestore.microsoft.com
的 Azure AD 访问令牌。 - 从应用中的客户端代码生成的过期 Microsoft Store ID 密钥。
有关详细信息,请参阅管理来自服务的产品授权。
请求
请求语法
密钥类型 | 方法 | 请求 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.com 或 purchase.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 声明不匹配。 |
相关主题
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈