다음을 통해 공유

GET(/users/me)

  • 아티클

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

쿼리 문자열 매개 변수

매개 변수 형식 설명
level 문자열 선택 사항.
  • user: 사용자 노드만 반환합니다.
  • device: 사용자 노드와 장치 노드를 반환합니다.
  • title: 기본값입니다. 활동을 제외한 전체 트리를 반환합니다.
  • all: 활동 레벨 프레즌스를 포함하여 전체 트리를 반환합니다.

Authorization

유형 필수 설명 누락된 경우 응답
XUID 예 호출자의 Xbox 사용자 ID(XUID) 403 Forbidden

필수 요청 헤더

헤더 유형 설명
Authorization 문자열 HTTP 인증을 위한 인증 자격 증명입니다. 예제 값: "XBL3.0 x=<userhash>;<token>".
x-xbl-contract-version 문자열 이 요청을 연결해야 하는 Xbox LIVE 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 권한 부여 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 예제 값: 3, vnext.
수락 문자열 허용 가능한 콘텐츠-유형입니다. 프레즌스가 지원하는 대상은 application/json이지만 헤더에 지정되어야 합니다.
Accept-Language 문자열 응답의 문자열에 사용할 수 있는 로캘입니다. 예제 값: en-US.
Host 문자열 서버의 도메인 이름입니다. 예제 값: presencebeta.xboxlive.com.

선택적 요청 헤더

헤더 유형 설명
X-RequestedServiceVersion 이 요청을 연결해야 하는 Xbox LIVE 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 권한 부여 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 기본값: 1.

요청 본문

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

응답 본문

샘플 응답

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

{
  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/me