Skip to main content

​
POST (/users//people/xuids)

通过 XUID 从调用方的人员集合中获取人员。 这些 URI 的域为 social.xboxlive.com。

​
备注

POST 操作不会修改任何资源,因此无论执行一次或多次,都会产生相同的结果。

​
URI 参数

​
授权

| 类型 | 是否必需 | 说明 | 缺失时的响应 | | --- | --- | --- | --- | --- | --- | --- | | XUID | 是 | 调用方持有用户的 XBOX 用户 ID (XUID)。 | 401 Unauthorized |

​
必需的请求标头

| 标头 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization | String。XBOX LIVE 的授权数据。这通常是经过加密的 XSTS 令牌。示例值:XBL3.0 x=<userhash>;<token>。 | | Content-Length | 32 位无符号整数。请求正文的字节长度。示例值:22。 | | Content-Type | String。请求正文的 MIME 类型。此项必须为 application/json。 |

​
可选的请求标头

| 标头 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion | 此请求应指向的 XBOX LIVE 服务的生成名称/编号。仅在验证标头的有效性、身份验证令牌中的声明等的有效性之后,请求才会路由到该服务。默认值:1。 | | Accept | String。调用方在响应中接受的 Content-Type。所有响应均为 application/json。 |

​
请求正文

​
必需成员

| 成员 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | XuidList | 一个 XUID 数组,用于标识要从调用方的人员集合返回的人员。请参阅 XuidList (JSON)。 |

​
可选成员

此请求没有可选成员。

​
禁止的成员

请求中禁止所有其他成员。

​
示例请求

​
HTTP 状态代码

服务针对使用此方法对此资源发出的请求,返回本节中的一个状态代码。有关 XBOX Live 服务使用的标准 HTTP 状态代码的完整列表,请参阅标准 HTTP 状态代码。 | 代码 | 原因短语 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200 | OK | 方法为 “get” 时表示成功。 | | 204 | No Content | 方法为 “add” 或 “remove” 时表示成功。 | | 400 | Bad Request | Method 参数缺失或格式错误,或者用户 ID 格式错误。 | | 403 | Forbidden | 无法从授权标头解析 XUID 声明。 |

​
必需的响应标头

| 标头 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Length | 32 位无符号整数 | 响应正文的字节长度。示例值:22。 | | Content-Type | string | 响应正文的 MIME 类型。始终为 application/json。 |

​
响应正文

只有当请求方法为 “get” 时才发送响应正文。对于 “add” 或 “remove”,没有响应正文。 如果 “get” 方法调用成功,服务会返回调用方人员集合中的人员总数,以及一个包含调用方人员集合的数组。对于 “add” 和 “remove” 方法不返回响应。请参阅 PeopleList (JSON)。

​
示例响应

​
另请参阅

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