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

# GET (/users/{ownerId}/people/{targetid})

> GET (/users/{ownerId}/people/{targetid})

# GET (/users/{ownerId}/people/{targetid})

호출자의 people 컬렉션에서 대상 ID로 person을 가져옵니다.
이러한 URI의 도메인은 `social.xboxlive.com`입니다.

* [설명](#ID4EV)
* [URI 매개 변수](#ID4E5)
* [권한 부여](#ID4EJB)
* [필수 요청 헤더](#ID4ERC)
* [선택적 요청 헤더](#ID4EQD)
* [요청 본문](#ID4EWE)
* [HTTP 상태 코드](#ID4EBF)
* [필수 응답 헤더](#ID4EDH)
* [응답 본문](#ID4EQAAC)

## 설명

GET 작업은 리소스를 수정하지 않으므로, 한 번 실행하든 여러 번 실행하든 동일한 결과를 생성합니다.

## URI 매개 변수

| 매개 변수 | 형식 | 설명 |
| - | - | - |
| ownerId | string | 리소스에 액세스하는 사용자의 식별자입니다. 인증된 사용자와 일치해야 합니다. 가능한 값은 “me”, xuid({xuid}) 또는 gt({gamertag})입니다. |
| targetid | string | 소유자의 People 목록에서 데이터를 검색할 사용자의 식별자로, XBOX User ID(XUID) 또는 게이머태그입니다. 예시 값: xuid(2603643534573581), gt(SomeGamertag). |

## 권한 부여

\| 형식| 필수| 설명| 누락 시 응답|
\| --- | --- | --- | --- | --- | --- | --- |
\| XUID| 예| 호출자에게 사용자의 XBOX User ID(XUID)가 있습니다.| 401 Unauthorized|

## 필수 요청 헤더

\| 헤더| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| String. XBOX LIVE에 대한 권한 부여 데이터입니다. 이는 일반적으로 암호화된 XSTS 토큰입니다. 예시 값: **XBL3.0 x=\<userhash>;\<token>**.|

## 선택적 요청 헤더

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

## 요청 본문

이 요청의 본문에는 개체가 전송되지 않습니다.

## HTTP 상태 코드

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

\| 코드| Reason phrase| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| 성공.|
\| 400| Bad Request| 사용자 ID가 잘못된 형식입니다.|
\| 403| Forbidden| authorization 헤더에서 XUID 클레임을 구문 분석할 수 없습니다.|
\| 404| Not Found| 소유자의 People 목록에서 대상 사용자를 찾을 수 없습니다.|

## 필수 응답 헤더

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

## 응답 본문

호출이 성공하면 서비스가 대상 person을 반환합니다. [Person (JSON)](https://devdocs.xbox.com/ko/reference/live/rest/json/json-person)을 참고하십시오.

### 샘플 응답

```cpp theme={null}
{
    "xuid": "2603643534573581",
    "isFavorite": false,
    "isFollowingCaller": false,
    "socialNetworks": ["LegacyXboxLive"]
}
         
```

## 참고 항목

##### 상위

[/users/{ownerId}/people/{targetid}](https://devdocs.xbox.com/ko/reference/live/rest/uri/people/uri-usersowneridpeopletargetid)


## 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)
- [Privacy and permissions overview](https://devdocs.xbox.com/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [XblMultiplayerGetActivitiesWithPropertiesForSocialGroupAsync](https://devdocs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitieswithpropertiesforsocialgroupasync.md)
- [XblMultiplayerGetActivitiesForSocialGroupAsync](https://devdocs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitiesforsocialgroupasync.md)