在尋找 Microsoft Store 服務對服務 REST 參考 (collections、purchase、clawback、grant、recurrences) 嗎?它位於 API 索引標籤下的 Microsoft Store REST API。
本節內容
開始使用
概觀、產品類型、Partner Center 設定、測試、授權和疑難排解。
基本概念
基本商店作業、DLC、試用版、消耗性產品、組合包、DWOB 和更新。
從您的服務管理
驗證服務、查詢權利、訂閱、退款和 User Store ID。
PC 專屬考量
DRM、授權權杖、不相符商店帳戶處理,以及沙箱切換。
Microsoft Store REST API
v8/v9 collections、purchase、clawback、grant 和 recurrences 端點的參考。完整參考現在位於 API 索引標籤下的 Microsoft Store REST API。
系列遊戲中心
將多個產品歸類在單一商店系列中心之下。
全貌:各部分如何連結
- Partner Center — 您在此建立產品 (基礎遊戲、附加元件、組合包、季票、訂閱、消耗性產品)、定義定價和供應情況,並指派識別碼 (StoreId、Product ID、BigId、SKU ID)。
MicrosoftGame.config— 隨附於您的遊戲套件中,並透過TitleId、StoreId和MSAAppId將執行中的可執行檔繫結至商店產品。- XStore 執行階段 API (
XStore*) — 從遊戲發出的用戶端呼叫,用於列舉產品、查詢授權和權利、顯示購買 UI,以及回報消耗性產品履行。 - XPackage API (
XPackage*) — 掛接選用套件 (DLC) 並為其授權、安裝區塊,以及觀察套件狀態變更。 - Microsoft Store S2S REST API — 您的後端呼叫的伺服器端端點,用於權威性地查詢權利、履行消耗性產品、授與產品、查閱訂閱,以及處理退款/撤銷。
- User Store ID (UserStoreId) — 短期金鑰,您的遊戲透過
XUserGetTokenAndSignatureAsync(或XStoreGetUserCollectionsIdAsync/XStoreGetUserPurchaseIdAsync) 取得並交給您的服務,讓服務能代表該使用者呼叫商店。
用戶端與服務
幾乎每個商店案例都同時有用戶端 (XStore) 和服務端 (S2S REST) 路徑。使用用戶端提供即時使用者體驗 (顯示購買按鈕、解除鎖定內容、回報消耗性產品花費);當權威性很重要時則使用服務 (履行必須在遊戲重新安裝後仍保留的虛擬貨幣花費、授與促銷項目、偵測 Game Pass、處理退款)。 可靠的模式:- 用戶端偵測到購買或花費,並顯示即時使用者體驗。
- 用戶端將 UserStoreId 傳送至您的服務。
- 服務呼叫商店 S2S API 以確認權利或履行消耗性產品,並更新您的記錄資料庫。
