purchase.mp.microsoft.com/v8.0/b2b/clawback/sastoken
此终结点用于生成 SAS 令牌,以对你的 Clawback 事件消息队列进行身份验证和访问。 有关 Clawback 事件消息队列的详细信息,请参阅管理服务的退款和退单拒付。
先决条件
若要使用此 API,必须在开发人员合作伙伴经理或 Microsoft 联系人协助下完成载入过程。
- 服务用于向 Microsoft Store 服务进行身份验证的 Microsoft Entra 应用程序客户端 ID,合作伙伴中心中的产品将链接到(请参阅 使用用户 Store ID/Microsoft Entra ID 身份验证查看和管理产品所需的其他配置)
- 你希望将你的 Clawback 事件消息队列托管为减少延迟的地理区域。
作为载入的一部分,Microsoft 将设置并托管 Azure 存储队列作为 Clawabck 事件队列。 载入过程可能需要长达两周的时间,具体取决于部署计划。
注意
如果尚未通过合作伙伴中心完成和发布产品配置,则这些产品的 Clawback 事件不会写入 Azure 存储队列。
请求
请求语法
方法 | 请求 URI |
---|---|
GET |
purchase.mp.microsoft.com/v8.0/b2b/clawback/sastoken |
请求头文件
标头 | 类型 | 说明 |
---|---|---|
Authorization |
string |
必需。 格式为 Bearer <令牌> 的 Microsoft Entra ID 服务访问令牌。 请参阅 创建 Microsoft Entra ID 访问令牌。 |
Host |
string |
必须设置为值 purchase.mp.microsoft.com 。 |
请求示例
POST https://purchase.mp.microsoft.com/v8.0/b2b/clawback/sastoken HTTP/1.1
Host: purchase.mp.microsoft.com
Authorization: Bearer [Microsoft Entra ID bearer token]
响应
响应正文
响应正文将为 JSON,由以下值组成。
参数 | 类型 | 说明 | 必需 |
---|---|---|---|
expiresOn |
DateTime |
UTC 日期和时间 SAS 令牌过期 | 是 |
uri |
string |
结合存储资源 URI 和 SAS 令牌 来访问 Clawabck 消息队列。 | 是 |
响应示例
HTTP/1.1 200 OK
Date: Thu, 08 Dec 2022 20:13:46 GMT
Content-Length: 243
Content-Type: application/json; charset=utf-8
ms-correlationid: 70e6f659-ceee-4050-bdf3-56ea3beefe23
ms-requestid: 8c80d7ff-73e2-4a5c-9aca-79059fbc1beb
ms-cv: tRscYtHLJHps.0
x-content-type-options: nosniff
{
"expiresOn":"2022-12-09T02:13Z",
"uri":"https://uluufeofsxh2k.queue.core.windows.net:443/gxhxcvb32lnk4?sv=2021-10-04&spr=https&st=2022-12-08T20%3A13%3A46Z&se=2022-12-09T02%3A13%3A46Z&sp=rp&sig=OneHfX99E820avICZvXJUF14IyDuv2BrvY0kj%2Ftxc70%3D"
}
使用 SAS 令牌访问 Clawback 事件消息队列
获得 URI 参数后,可以访问队列中的消息。
有关详细信息,请参阅 处理队列中的 Clawback 消息。