正在寻找 Microsoft Store 服务到服务 REST 参考(collections、purchase、clawback、grant、recurrences)?它位于 API 选项卡下的 Microsoft Store REST API。
本节内容
入门
概述、产品类型、合作伙伴中心设置、测试、授权和故障排除。
基础知识
商店基本操作、DLC、试玩、消耗品、捆绑包、DWOB 以及更新。
从你的服务管理
对服务进行身份验证、查询权益、订阅、退款以及 User Store ID。
PC 特有注意事项
DRM、许可证令牌、商店账号不匹配的处理,以及沙盒切换。
Microsoft Store REST API
v8/v9 collections、purchase、clawback、grant 和 recurrences 端点的参考。完整参考现位于 API 选项卡下的 Microsoft Store REST API。
系列游戏中心
将多个产品归入同一个 Store 系列中心。
全景:各部分如何协同工作
- 合作伙伴中心 — 你在其中创建产品(基础游戏、附加内容、捆绑包、季票、订阅、消耗品),定义定价与可用性,并分配标识符(StoreId、Product ID、BigId、SKU ID)。
MicrosoftGame.config— 随游戏包一起发布,通过TitleId、StoreId和MSAAppId将运行的可执行文件与 Store 产品绑定。- XStore 运行时 API (
XStore*) — 从游戏发起的客户端调用,用于枚举产品、查询许可证与权益、显示购买 UI,以及报告消耗品履约。 - XPackage API (
XPackage*) — 挂载并授权可选包(DLC)、安装区块,并观察包状态变化。 - Microsoft Store S2S REST API — 你的后端调用的服务端端点,用于权威地查询权益、履约消耗品、发放产品、查找订阅以及处理退款/追索。
- User Store ID (UserStoreId) — 一种短期密钥,你的游戏通过
XUserGetTokenAndSignatureAsync(或XStoreGetUserCollectionsIdAsync/XStoreGetUserPurchaseIdAsync)获得,然后交给你的服务,让服务可以代表该用户调用 Store。
客户端与服务
几乎每种 Store 场景都同时有 客户端(XStore)和 服务端 (S2S REST) 路径。使用客户端处理实时 UX(显示购买按钮、解锁内容、上报一次消耗品消费);当权威性重要时使用服务端(例如:履约一次必须在游戏重装后仍生效的虚拟货币消费、发放促销物品、检测 Game Pass、处理退款)。 一个可靠的模式:- 客户端检测到购买或消费并显示即时 UX。
- 客户端向你的服务发送 UserStoreId。
- 服务调用 Store S2S API 确认权益或履约消耗品,并更新你的记录数据库。
