> ## 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.

# POST (/users/{ownerId}/people/xuids)

> POST (/users/{ownerId}/people/xuids)

# POST (/users/{ownerId}/people/xuids)

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

* [备注](#ID4EV)
* [URI 参数](#ID4E5)
* [授权](#ID4EJB)
* [必需的请求标头](#ID4ERC)
* [可选的请求标头](#ID4EBE)
* [请求正文](#ID4EHF)
* [HTTP 状态代码](#ID4EKH)
* [必需的响应标头](#ID4ENBAC)
* [响应正文](#ID4EZCAC)

## 备注

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

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| ownerId | string | 正在访问其资源的用户的标识符。必须与经过身份验证的用户匹配。可能的值为 "me"、xuid({xuid}) 或 gt({gamertag})。 |

## 授权

\| 类型 | 是否必需 | 说明 | 缺失时的响应 |
\| --- | --- | --- | --- | --- | --- | --- |
\| 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)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-xuidlist)。 |

### 可选成员

此请求没有可选成员。

### 禁止的成员

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

### 示例请求

```cpp theme={null}
{
    "xuids": [
        "2533274790395904", 
        "2533274792986770", 
        "2533274794866999"
    ]
}
      
```

## HTTP 状态代码

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

\| 代码 | 原因短语 | 说明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 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)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-peoplelist)。

### 示例响应

```cpp theme={null}
{
    "people": [
        {
            "xuid": "2603643534573573",
            "isFavorite": true,
            "isFollowingCaller": false,
            "socialNetworks": ["LegacyXboxLive"]
        },
        {
            "xuid": "2603643534573572",
            "isFavorite": true,
            "isFollowingCaller": false,
            "socialNetworks": ["LegacyXboxLive"]
        },
        {
            "xuid": "2603643534573577",
            "isFavorite": false,
            "isFollowingCaller": false
        },
    ],
    "totalCount": 3
}
         
```

## 另请参阅

##### 父主题

[/users/{ownerId}/people/xuids](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/people/uri-usersowneridpeoplexuids)


## Related topics

- [Displaying people from the People System](https://devdocs.xbox.com/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)
- [XblPresenceGetPresenceForSocialGroupAsync](https://devdocs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md)
- [XblMultiplayerGetActivitiesWithPropertiesForSocialGroupAsync](https://devdocs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitieswithpropertiesforsocialgroupasync.md)
- [People System에서 사람 표시하기](https://devdocs.xbox.com/ko/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)
- [XblMultiplayerGetActivitiesForSocialGroupAsync](https://devdocs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitiesforsocialgroupasync.md)