GET (/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite})
通过对当前用户的所有已知联系人或仅该用户指定为收藏人员的联系人的统计值(得分)进行排名,返回社交排行榜。 这些 URI 的域为leaderboards.xboxlive.com。
备注
排行榜 API 都是只读的,因此仅支持 GET 谓词(通过 HTTPS)。它们反映了按索引玩家统计信息进行排名和排序的”页面”,这些统计信息派生自通过 Player Data 系统写入的各个用户统计信息。完整的排行榜索引可能非常大,而调用者绝不会要求查看其全部内容,因此此 URI 支持多个查询字符串参数,允许调用者具体指定要查看该排行榜的哪种视图。 GET 操作不会修改任何资源,因此无论执行一次还是多次都会产生相同的结果。URI 参数
查询字符串参数
授权
需要 Xuid 授权。 针对内容隔离和访问控制场景,实施了授权逻辑。 只要调用者随请求提交有效的 XSTS 令牌,任何平台上的客户端都可以读取排行榜和用户统计信息。写入(显然)仅限于 Player Data 系统支持的客户端。 游戏开发者可以使用 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
