跳轉到主要內容

GET (/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite})

將目前使用者所有已知連絡人的統計資料值 (分數) 排名,或僅將該使用者指定為最愛人員的連絡人排名,以傳回社交排行榜。 這些 URI 的網域為 leaderboards.xboxlive.com。

備註

排行榜 API 全部都是唯讀的,因此僅支援 GET 動詞 (透過 HTTPS)。它們反映已編製索引之玩家統計資料的排名和排序「頁面」,這些統計資料衍生自透過玩家資料系統寫入的個別使用者統計資料。完整的排行榜索引可能相當大,而呼叫者永遠不會要求查看完整的索引,因此此 URI 支援數個查詢字串引數,讓呼叫者可以明確指定要查看該排行榜的哪種檢視。 GET 作業不會修改任何資源,因此無論執行一次或多次,都會產生相同的結果。

URI 參數

查詢字串參數

授權

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

必要的要求標頭

選用的要求標頭

要求本文

為了讓任何呼叫者都能充分理解所取回的資料以正確顯示,每位使用者的每個統計資料值都會以應顯示的格式作為字串傳回,並依照要求中 accept-language 標頭所指定的地區設定進行格式化。該排行榜的 statname 也會傳回當地語系化的「顯示名稱」。

必要成員

HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼,以回應在此資源上使用此方法所提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單,請參閱標準 HTTP 狀態碼。

必要的回應標頭

選用的回應標頭

回應本文

社交排行榜的要求,無分頁: https://leaderboards.xboxlive.com/users/xuid(2533274916402282)/scids/c1ba92a9-0000-0000-0000-000000000000/stats/EnemyDefeats/people/all?sort=descending

回應範例

另請參閱

/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite}
最後修改於 2026年11月5日