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

아티클
05/10/2023

다른 사용자 또는 클라이언트의 프레즌스를 검색합니다. 이 URI의 도메인은 userpresence.xboxlive.com입니다.

비고
URI 매개 변수
쿼리 문자열 매개 변수
Authorization
리소스에 대한 개인 정보 설정의 영향
필수 요청 헤더
선택적 요청 헤더
요청 본문
응답 본문

설명

소비자가 전체 개체에 관심이 없는 경우 PresenceRecord의 일부를 제공하도록 응답을 필터링할 수 있습니다.

참고:
반환된 데이터는 개인 정보 및 콘텐츠 격리 규칙에 의해 제한됩니다.

URI 매개 변수

매개 변수	형식	설명
xuid	64비트 부호 없는 정수	대상 사용자의 Xbox 사용자 ID(XUID).

쿼리 문자열 매개 변수

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

Authorization

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

리소스에 대한 개인 정보 설정의 영향

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

요청 사용자	대상 사용자의 개인 정보 설정	동작
나	-	200 OK
친구	모두	200 OK
친구	친구만	200 OK
친구	차단	200 OK
친구가 아닌 사용자	모두	200 OK
친구가 아닌 사용자	친구만	200 OK
친구가 아닌 사용자	차단	200 OK
타사 사이트	모두	200 OK
타사 사이트	친구만	200 OK
타사 사이트	차단	200 OK

필수 요청 헤더

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

요청 본문

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

응답 본문

샘플 응답

사용자에 대한 기존 레코드가 없는 경우 장치가 없는 레코드가 반환됩니다.

{
  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})

다음을 통해 공유