Skip to main content

GET (/users/xuid())

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

설명

전체 개체에 관심이 없는 경우, PresenceRecord의 일부만 제공하도록 응답을 필터링할 수 있습니다.
참고:
반환된 데이터는 개인 정보 및 콘텐츠 격리 규칙에 의해 제약을 받습니다.

URI 매개 변수

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

쿼리 문자열 매개 변수

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

권한 부여

| 형식| 필수| 설명| 누락 시 응답| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 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.|

요청 본문

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

응답 본문

샘플 응답

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

참고 항목

상위
/users/xuid()
Last modified on October 19, 2026