Skip to main content

GET (/users/me)

사용자의 XUID를 알 필요 없이 현재 사용자의 PresenceRecord를 가져옵니다. 이러한 URI의 도메인은 userpresence.xboxlive.com입니다.

쿼리 문자열 매개 변수

권한 부여

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

필수 요청 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 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.|

요청 본문

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

응답 본문

샘플 응답

이 메서드는 PresenceRecord를 반환합니다.

참고 항목

상위
/users/me
Last modified on October 19, 2026