> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET (/users/xuid({xuid})/scids/{scid}/stats?include=valuemetadata)

> GET (/users/xuid({xuid})/scids/{scid}/stats?include=valuemetadata)

# GET (/users/xuid({xuid})/scids/{scid}/stats?include=valuemetadata)

获取指定服务配置中某用户的指定统计信息列表,包括与统计信息值相关联的元数据。
这些 URI 的域为 `userstats.xboxlive.com`。

* [备注](#ID4EV)
* [URI 参数](#ID4EAB)
* [查询字符串参数](#ID4ELB)
* [授权](#ID4EWC)
* [必需的请求标头](#ID4ERD)
* [可选的请求标头](#ID4EDF)
* [请求正文](#ID4EHG)
* [HTTP 状态代码](#ID4ESG)
* [响应正文](#ID4EJCAC)

## 备注

?include=valuemetadata 查询参数允许响应包含与用户统计信息值相关联的任何元数据,例如用于在赛道上达到某一时间的汽车的型号和颜色。

要在响应中包含值元数据,请求调用还必须将标头值 X-Xbl-Contract-Version 设置为 3。

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| xuid | GUID | 代表其访问服务配置的用户的 XBOX User ID (XUID)。 |
| scid | GUID | 包含所访问资源的服务配置的标识符。 |

## 查询字符串参数

\| 参数 | 类型 | 说明 |
\| --- | --- | --- | --- | --- | --- |
\| statNames | string | 以逗号分隔的用户统计信息名称列表。例如,以下 URI 通知服务:代表 URI 中指定的用户 ID 请求四项统计信息。\{::nomakrdown}\
\
`https://userstats.xboxlive.com/users/xuid({xuid})/scids/{scid}/stats/wins,kills,kdratio,headshots?include=valuemetadata` |
\| include=valuemetadata | string | 指示响应包含与用户统计信息值相关联的任何值元数据。 |

## 授权

为内容隔离和访问控制场景实现了授权逻辑。

* 排行榜和用户统计信息都可以由任何平台上的客户端读取,前提是调用方在请求中提交有效的 XSTS 令牌。写入仅限于 Player Data 系统支持的客户端。
* 标题开发者可以在 Partner Center 将统计信息标记为开放或受限。排行榜是开放统计信息。只要用户已获得对沙盒的授权,开放统计信息就可以由 Smartglass 以及 iOS、Android、Windows、Windows Phone 和 Web 应用程序访问。用户对沙盒的授权通过 Partner Center 管理。

该检查的伪代码如下:

```cpp theme={null}
If (!checkAccess(serviceConfigId, resource, CLAIM[userid, deviceid, titleid]))
{
        Reject request as Unauthorized
}

// else accept request.

```

## 必需的请求标头

\| 标头 | 类型 | 说明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization | string | 用于 HTTP 身份验证的凭据。示例值:"XBL3.0 x=\<userhash>;\<token>"。 |
\| X-Xbl-Contract-Version | string | 指示要使用的 API 版本。要在响应中包含值元数据,该值必须设置为 "3"。 |

## 可选的请求标头

\| 标头 | 类型 | 说明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| X-RequestedServiceVersion |  | 此请求应发送到的服务的生成名称/编号。仅在验证标头的有效性、认证令牌中的声明等之后,请求才会被路由到该服务。默认值:1。 |

## 请求正文

此请求的正文中不发送任何对象。

## HTTP 状态代码

服务针对使用此方法对此资源发出的请求,返回本节中的某个状态代码。有关与 XBOX Live 服务一同使用的标准 HTTP 状态代码的完整列表,请参见 [标准 HTTP 状态代码](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/httpstatuscodes)。

\| 代码 | 原因短语 | 说明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200 | OK | 已成功检索会话。 |
\| 304 | Not Modified | 自上次请求以来资源未被修改。 |
\| 400 | Bad Request | 服务无法理解格式错误的请求。通常是无效参数。 |
\| 401 | Unauthorized | 请求需要用户身份验证。 |
\| 403 | Forbidden | 不允许该用户或服务发出请求。 |
\| 404 | Not Found | 找不到指定的资源。 |
\| 406 | Not Acceptable | 不支持资源版本。 |
\| 408 | Request Timeout | 不支持资源版本;应由 MVC 层拒绝。 |

## 响应正文

### 响应示例

```cpp theme={null}
{
  "user": {
    "xuid": "123456789",
    "gamertag": "WarriorSaint",
    "stats": [
      {
        "statname": "Wins",
        "type": "Integer",
        "value": 40,
        "valuemetadata" : "{\"region\" : \"EU\", \"isRanked\" : true}"
      },
      {
        "statname": "Kills",
        "type": "Integer",
        "value": 700,
        "valuemetadata" : "{\"longestKillStreak" : 15, \"favoriteTarget\" : \"CrazyPigeon\"}"
      },
      {
        "statname": "KDRatio",
        "type": "Double",
        "value": 2.23,
        "valuemetadata" : "{\"totalKills\" : 700, \"totalDeaths\" : 314}"
      },
      {
        "statname": "Headshots",
        "type": "Integer",
        "value": 173,
        "valuemetadata" : ""
      }
    ],
  }
}

```

## 另请参阅

##### 父主题

[/users/xuid({xuid})/scids/{scid}/stats](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/userstats/uri-usersxuidscidsscidstats)


## Related topics

- [XblUserStatisticsGetSingleUserStatisticAsync](https://devdocs.xbox.com/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md)
- [XblUserStatisticsGetSingleUserStatisticsAsync](https://devdocs.xbox.com/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsasync.md)