Skip to main content

​
GET (/users//summary)

从调用方的角度获取所有者的摘要数据。

​
URI 参数

​
授权

| 名称 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | | xuid | 64 位无符号整数 | 必需。调用方的用户标识符。示例值:2533274790395904 |

​
必需的请求标头

| 标头 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization | string | 授权数据。这通常是经过加密的 XSTS 令牌。示例值:XBL3.0 x=[hash];[token]。 |

​
可选的请求标头

| 标头 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version | string | 此请求应指向的服务的生成名称/编号。仅在验证标头的有效性、身份验证令牌中的声明等的有效性之后,请求才会路由到该服务。示例值:1 | | Accept | string | 可接受的 Content-Type。所有响应均将为 application/json。 |

​
请求正文

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

​
HTTP 状态代码

服务针对使用此方法对此资源发出的请求,返回本节中的一个状态代码。有关 XBOX Live 服务使用的标准 HTTP 状态代码的完整列表,请参阅标准 HTTP 状态代码。 | 代码 | 原因短语 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200 | OK | 已成功检索会话。 | | 400 | Bad Request | 用户 ID 格式错误。 | | 403 | Forbidden | 无法从授权标头解析 XUID 声明。 |

​
必需的响应标头

| 标头 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Length | string | 响应中发送的字节数。示例值:232。 | | Content-Type | string | 响应正文的 MIME 类型。此项必须为 application/json。 |

​
响应正文

请参阅 PersonSummary (JSON)。

​
示例响应

​
另请参阅

父主题
/users//summary
Last modified on October 19, 2026