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

호출자의 people 컬렉션에서 XUID로 people을 가져옵니다.
이러한 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 User ID(XUID)가 있습니다.| 401 Unauthorized|

## 필수 요청 헤더

\| 헤더| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| String. XBOX LIVE에 대한 권한 부여 데이터입니다. 이는 일반적으로 암호화된 XSTS 토큰입니다. 예시 값: **XBL3.0 x=\<userhash>;\<token>**.|
\| Content-Length| 32-bit unsigned integer. 요청 본문의 길이(바이트)입니다. 예시 값: 22.|
\| Content-Type| String. 요청 본문의 MIME 형식입니다. 이는 **application/json**이어야 합니다.|

## 선택적 요청 헤더

\| 헤더| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| X-RequestedServiceVersion| 이 요청을 라우팅해야 하는 XBOX LIVE 서비스의 빌드 이름/번호입니다. 헤더의 유효성, 인증 토큰의 클레임 등을 검증한 후에만 요청이 해당 서비스로 라우팅됩니다. 기본값: 1.|
\| Accept| String. 호출자가 응답에서 허용하는 Content-Types입니다. 모든 응답은 **application/json**입니다.|

## 요청 본문

### 필수 멤버

\| 멤버| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| XuidList| 호출자의 people 컬렉션에서 반환할 people을 식별하는 XUID의 배열입니다. [XuidList (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-xuidlist)을 참고하십시오.|

### 선택적 멤버

이 요청에는 선택적 멤버가 없습니다.

### 금지된 멤버

요청에서 그 외 모든 멤버는 금지됩니다.

### 샘플 요청

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

## HTTP 상태 코드

이 리소스에서 이 메서드로 수행한 요청에 대한 응답으로 서비스는 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 [Standard HTTP status codes](https://devdocs.xbox.com/ko/reference/live/rest/additional/httpstatuscodes)를 참고하십시오.

\| 코드| Reason phrase| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| 메서드가 “get”일 때의 성공.|
\| 204| No Content| 메서드가 “add” 또는 “remove”일 때의 성공.|
\| 400| Bad Request| 메서드 매개 변수가 누락되었거나 잘못된 형식이거나 사용자 ID가 잘못된 형식입니다.|
\| 403| Forbidden| authorization 헤더에서 XUID 클레임을 구문 분석할 수 없습니다.|

## 필수 응답 헤더

\| 헤더| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Length| 32-bit unsigned integer| 응답 본문의 길이(바이트)입니다. 예시 값: 22.|
\| Content-Type| string| 응답 본문의 MIME 형식입니다. 이는 항상 **application/json**입니다.|

## 응답 본문

응답 본문은 요청 메서드가 “get”일 때만 전송됩니다. “add” 또는 “remove”에는 응답 본문이 없습니다.

“get” 메서드 호출이 성공하면 서비스는 호출자의 people 컬렉션에 있는 people의 총 수와 호출자의 people 컬렉션을 포함하는 배열을 반환합니다. “add” 및 “remove” 메서드에는 응답이 반환되지 않습니다. [PeopleList (JSON)](https://devdocs.xbox.com/ko/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/ko/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)