Skip to main content

GET (/users/me)

无需知道用户的 XUID 即可获取当前用户的 PresenceRecord。 这些 URI 的域为 userpresence.xboxlive.com。

查询字符串参数

授权

| 类型 | 是否必需 | 说明 | 缺失时的响应 | | --- | --- | --- | --- | --- | --- | --- | | XUID | 是 | 调用方的 XBOX 用户 ID (XUID) | 403 Forbidden |

必需的请求标头

| 标头 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization | string | HTTP 身份验证的身份验证凭据。示例值:“XBL3.0 x=<userhash>;<token>”。 | | x-xbl-contract-version | string | 此请求应指向的 XBOX LIVE 服务的生成名称/编号。仅在验证标头的有效性、身份验证令牌中的声明等的有效性之后,请求才会路由到该服务。示例值:3、vnext。 | | Accept | string | 可接受的 Content-Type。在线状态服务仅支持 application/json,但必须在标头中指定。 | | Accept-Language | string | 响应中字符串的可接受区域设置。示例值:en-US。 | | Host | string | 服务器的域名。示例值:presencebeta.xboxlive.com。 |

可选的请求标头

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

请求正文

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

响应正文

示例响应

此方法返回 PresenceRecord。

另请参阅

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