续订 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: aaaa0000-bb11-2222-33cc-444444dddddd
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 声明不匹配。 |