Skip to main content

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

代表指定用户,获取以逗号分隔的用户统计信息名称列表范围内的服务配置。 这些 URI 的域为 userstats.xboxlive.com。

备注

客户端需要一种方式,代表玩家向我们新的玩家统计信息系统读写标题统计信息。

URI 参数

查询字符串参数

| 参数 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | | statNames | string | 唯一的查询字符串参数是以逗号分隔的用户统计信息名称 URI noun。例如,以下 URI 通知服务:代表 URI 中指定的用户 ID 请求四项统计信息。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 19, 2026