> ## 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/xuid({xuid}))

> GET (/users/xuid({xuid}))

# GET (/users/xuid({xuid}))

다른 사용자 또는 클라이언트의 프레즌스를 알아봅니다.
이러한 URI의 도메인은 `userpresence.xboxlive.com`입니다.

* [설명](#ID4EV)
* [URI 매개 변수](#ID4EDB)
* [쿼리 문자열 매개 변수](#ID4EOB)
* [권한 부여](#ID4E4C)
* [개인 정보 설정이 리소스에 미치는 영향](#ID4EAE)
* [필수 요청 헤더](#ID4EVH)
* [선택적 요청 헤더](#ID4E1BAC)
* [요청 본문](#ID4E1CAC)
* [응답 본문](#ID4EFDAC)

## 설명

전체 개체에 관심이 없는 경우, [PresenceRecord](https://devdocs.xbox.com/ko/reference/live/rest/json/json-presencerecord)의 일부만 제공하도록 응답을 필터링할 수 있습니다.

> **참고:**\
> 반환된 데이터는 개인 정보 및 콘텐츠 격리 규칙에 의해 제약을 받습니다.

## URI 매개 변수

\| 매개 변수| 형식| 설명|
\| --- | --- | --- | --- |
\| xuid| 64-bit unsigned integer| 대상 사용자의 XBOX User ID(XUID)입니다.|

## 쿼리 문자열 매개 변수

\| 매개 변수| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- |
\| level| string| 선택 사항. <ul><li>**user**: 사용자 노드만 반환합니다.</li><li>**device**: 사용자 노드와 디바이스 노드를 반환합니다.</li><li>**title**: 기본값. activity를 제외한 전체 트리를 반환합니다.</li><li>**all**: activity 수준 프레즌스를 포함하여 전체 트리를 반환합니다.</li></ul> |

## 권한 부여

\| 형식| 필수| 설명| 누락 시 응답|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| XUID| 예| 호출자의 XBOX User ID(XUID)| 403 Forbidden|

## 개인 정보 설정이 리소스에 미치는 영향

이 메서드는 항상 200 OK를 반환하지만, 응답 본문에 콘텐츠를 반환하지 않을 수 있습니다.

\| 요청 사용자| 대상 사용자의 개인 정보 설정| 동작|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| me| -| 200 OK|
\| friend| everyone| 200 OK|
\| friend| friends only| 200 OK|
\| friend| blocked| 200 OK|
\| non-friend user| everyone| 200 OK|
\| non-friend user| friends only| 200 OK|
\| non-friend user| blocked| 200 OK|
\| third-party site| everyone| 200 OK|
\| third-party site| friends only| 200 OK|
\| third-party site| blocked| 200 OK|

## 필수 요청 헤더

\| 헤더| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| HTTP 인증을 위한 인증 자격 증명입니다. 예시 값: “XBL3.0 x=\<userhash>;\<token>”.|
\| x-xbl-contract-version| string| 이 요청을 라우팅해야 하는 XBOX LIVE 서비스의 빌드 이름/번호입니다. 헤더의 유효성, 인증 토큰의 클레임 등을 검증한 후에만 요청이 해당 서비스로 라우팅됩니다. 예시 값: 3, vnext.|
\| Accept| string| 허용되는 Content-Types입니다. Presence가 지원하는 유일한 것은 application/json이지만, 헤더에 지정해야 합니다.|
\| Accept-Language| string| 응답의 문자열에 허용되는 로캘입니다. 예시 값: en-US.|
\| Host| string| 서버의 도메인 이름입니다. 예시 값: presencebeta.xboxlive.com.|

## 선택적 요청 헤더

\| 헤더| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| X-RequestedServiceVersion|  | 이 요청을 라우팅해야 하는 XBOX LIVE 서비스의 빌드 이름/번호입니다. 헤더의 유효성, 인증 토큰의 클레임 등을 검증한 후에만 요청이 해당 서비스로 라우팅됩니다. 기본값: 1.|

## 요청 본문

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

## 응답 본문

### 샘플 응답

사용자에 대한 기존 레코드가 없는 경우, 디바이스가 없는 레코드가 반환됩니다.

```json theme={null}
{
  xuid:"0123456789",
  state:"online",
  devices:
  [{
    type:"D",
    titles:
    [{
      id:"12341234",
      name:"Contoso 5",
      state:"active",
      placement:"fill",
      timestamp:"2012-09-17T07:15:23.4930000",
      activity:
      {
        richPresence:"Team Deathmatch on Nirvana"
      }
    },
    {
      id:"12341235",
      name:"Contoso Waypoint",
      timestamp:"2012-09-17T07:15:23.4930000",
      placement:"snapped",
      state:"active",
      activity:
      {
        richPresence:"Using radar"
      }
    }]
  },
  {
    type:W8,
    titles:
    [{
      id:"23452345",
      name:"Contoso Gamehelp",
      state:"active",
      placement:"full",
      timestamp:"2012-09-17T07:15:23.4930000",
      activity:
      {
        richPresence:"Nirvana page",
      }
    }]
  }]
}

```

## 참고 항목

##### 상위

[/users/xuid({xuid})](https://devdocs.xbox.com/ko/reference/live/rest/uri/presence/uri-usersxuid)


## Related topics

- [XblUserStatisticsGetSingleUserStatisticAsync](https://devdocs.xbox.com/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md)
- [XblUserStatisticsGetSingleUserStatisticsAsync](https://devdocs.xbox.com/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsasync.md)