GET(/users/{ownerId}/people/{targetid})

호출자의 피플 컬렉션에서 대상 ID별로 사용자를 가져옵니다. 이 URI의 도메인은 social.xboxlive.com입니다.

설명

GET 작업은 리소스를 수정하지 않으므로 한 번 또는 여러 번 실행하는 경우 동일한 결과가 생성됩니다.

매개 변수	형식	설명
ownerId	문자열	리소스에 액세스하는 사용자의 식별자입니다. 인증된 사용자와 일치해야 합니다. 가능한 값은 "me", xuid({xuid}) 또는 gt({gamertag})입니다.
targetid	문자열	소유자의 피플 목록에서 Xbox 사용자 ID(XUID) 또는 게이머태그 중 데이터를 검색하는 사용자의 식별자입니다. 예제 값: xuid(2603643534573581), gt(SomeGamertag).

유형	필수	설명	누락된 경우 응답
XUID	예	호출자에게 사용자의 Xbox 사용자 ID(XUID)가 있습니다.	401 권한 없음

헤더	설명
Authorization	문자열입니다. Xbox LIVE에 대한 인증 데이터. 일반적으로 암호화된 XSTS 토큰입니다. 예제 값: XBL3.0 x=<userhash>;<token>.

헤더	설명
X-RequestedServiceVersion	이 요청을 연결해야 하는 Xbox LIVE 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 권한 부여 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 기본 값은 1입니다.
수락	문자열입니다. 응답에서 호출자가 허용하는 Content-Type. 모든 응답은 application/json입니다.

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

서비스는 이 리소스에서 이 메서드를 통해 수행한 요청에 대한 응답으로 이 섹션의 상태 코드 중 하나를 반환합니다. Xbox Live 서비스에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 표준 HTTP 상태 코드를 참조하세요.

코드	이유 구문	설명
200	OK	성공.
400	Bad Request	사용자 ID가 잘못된 형식입니다.
403	Forbidden	XUID 클레임을 권한 부여 헤더에서 구문 분석할 수 없습니다.
404	Not Found	소유자의 피플 목록에서 대상 사용자를 찾을 수 없습니다.

헤더	유형	설명
Content-Length	32비트 부호 없는 정수	응답 본문의 길이(바이트)입니다. 예제 값: 22.
콘텐츠-종류	문자열	응답 본문의 MIME 유형. 항상 application/json입니다.

호출이 성공하면 서비스는 대상 인물을 반환합니다. Person(JSON)을 참조하세요.

{
    "xuid": "2603643534573581",
    "isFavorite": false,
    "isFollowingCaller": false,
    "socialNetworks": ["LegacyXboxLive"]
}