Skip to main content

GET (/users/xuid()/scids//stats)

代表指定的使用者,取得以逗號分隔的使用者統計資料名稱清單為範圍的服務設定。 這些 URI 的網域為 userstats.xboxlive.com。

備註

用戶端需要一種方式,代表玩家將遊戲統計資料讀取和寫入我們的新玩家統計資料系統。

URI 參數

查詢字串參數

| 參數| 類型| 描述| | --- | --- | --- | --- | --- | --- | | statNames| string| 唯一的查詢字串參數是以逗號分隔的使用者統計資料名稱 URI 名詞。例如,下列 URI 會通知服務,代表 URI 中指定的使用者識別碼要求四項統計資料。https://userstats.xboxlive.com/users/xuid({xuid})/scids/{scid}/stats/wins,kills,kdratio,headshots單一呼叫中可要求的統計資料數目會有限制,而該限制會仔細考量開發人員便利性與 URI 長度實用性之間的「最佳平衡點」。例如,限制可能取決於 600 個字元的統計資料名稱文字 (包括逗號),或最多 10 項統計資料。啟用像這樣的簡單 GET,可以為經常要求的統計資料啟用 HTTP 快取,進而減少頻繁呼叫之用戶端的呼叫量。 |

授權

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

必要的要求標頭

| 標頭| 類型| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| HTTP 驗證的驗證認證。範例值:“XBL3.0 x=<userhash>;<token>”。|

選用的要求標頭

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

要求本文

此要求的本文中不會傳送任何物件。

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 層拒絕。|

回應本文

範例回應

另請參閱

上層
/users/xuid()/scids//stats
Last modified on October 6, 2026