Skip to main content

POST (/batch)

POST 方法,針對跨多個遊戲的多個玩家統計資料的複雜批次要求,其作用如同 GET 方法。 這些 URI 的網域為 userstats.xboxlive.com。

備註

遊戲開發人員可以使用 Partner Center 將統計資料標示為開放或受限制。排行榜是開放的統計資料。只要使用者已獲授權存取沙箱,Smartglass 以及 iOS、Android、Windows、Windows Phone 和 Web 應用程式就可以存取開放的統計資料。使用者對沙箱的授權是透過 Partner Center 管理。

描述

呼叫端會提供訊息本文,其中包含使用者陣列、服務設定識別碼 (SCID),以及每個 SCID 要擷取的統計資料名稱清單。 在閱讀此較複雜的批次模式頁面之前,您可能會發現先檢閱簡單的單一統計資料 GET 方法更有幫助。

授權

針對內容隔離和存取控制案例,已實作授權邏輯。
  • 只要呼叫端隨要求提交有效的 XSTS 權杖,任何平台上的用戶端都可以讀取排行榜和使用者統計資料。寫入作業顯然僅限於 支援的用戶端。
  • 遊戲開發人員可以使用 Partner Center 將統計資料標示為開放或受限制。排行榜是開放的統計資料。只要使用者已獲授權存取沙箱,Smartglass 以及 iOS、Android、Windows、Windows Phone 和 Web 應用程式就可以存取開放的統計資料。使用者對沙箱的授權是透過 Partner Center 管理。
下列範例是檢查的虛擬程式碼:

必要的要求標頭

選用的要求標頭

| 標頭| 類型| 描述| | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| | 此要求應導向之服務的組建名稱/編號。只有在驗證標頭的有效性、驗證權杖中的宣告等之後,要求才會路由至該服務。預設值:1。|

要求本文

範例要求

下列 POST 本文會通知服務,正在為兩個不同的使用者從兩個不同的 SCID 要求四項統計資料。

HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼,以回應在此資源上使用此方法所提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單,請參閱標準 HTTP 狀態碼。 | 代碼| 原因片語| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| 已成功擷取工作階段。| | 304| Not Modified| 自上次要求後資源未曾修改。| | 400| Bad Request| 服務無法理解格式錯誤的要求。通常是無效的參數。| | 401| Unauthorized| 要求需要使用者驗證。| | 403| Forbidden| 不允許使用者或服務提出此要求。| | 404| Not Found| 找不到指定的資源。| | 406| Not Acceptable| 不支援資源版本。| | 408| Request Timeout| 不支援資源版本;應由 MVC 層拒絕。|

回應本文

範例回應

另請參閱

上層
/batch
Last modified on October 6, 2026