GET (/users//people/)

호출자의 people 컬렉션에서 대상 ID로 person을 가져옵니다. 이러한 URI의 도메인은 social.xboxlive.com입니다.

설명
URI 매개 변수
권한 부여
필수 요청 헤더
선택적 요청 헤더
요청 본문
HTTP 상태 코드
필수 응답 헤더
응답 본문

설명

GET 작업은 리소스를 수정하지 않으므로, 한 번 실행하든 여러 번 실행하든 동일한 결과를 생성합니다.

URI 매개 변수

매개 변수	형식	설명
ownerId	string	리소스에 액세스하는 사용자의 식별자입니다. 인증된 사용자와 일치해야 합니다. 가능한 값은 “me”, xuid() 또는 gt()입니다.
targetid	string	소유자의 People 목록에서 데이터를 검색할 사용자의 식별자로, XBOX User ID(XUID) 또는 게이머태그입니다. 예시 값: xuid(2603643534573581), gt(SomeGamertag).

권한 부여

| 형식| 필수| 설명| 누락 시 응답| | --- | --- | --- | --- | --- | --- | --- | | XUID| 예| 호출자에게 사용자의 XBOX User ID(XUID)가 있습니다.| 401 Unauthorized|

필수 요청 헤더

| 헤더| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| String. XBOX LIVE에 대한 권한 부여 데이터입니다. 이는 일반적으로 암호화된 XSTS 토큰입니다. 예시 값: XBL3.0 x=<userhash>;<token>.|

선택적 요청 헤더

| 헤더| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| 이 요청을 라우팅해야 하는 XBOX LIVE 서비스의 빌드 이름/번호입니다. 헤더의 유효성, 인증 토큰의 클레임 등을 검증한 후에만 요청이 해당 서비스로 라우팅됩니다. 기본값: 1.| | Accept| String. 호출자가 응답에서 허용하는 Content-Types입니다. 모든 응답은 application/json입니다.|

요청 본문

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

HTTP 상태 코드

이 리소스에서 이 메서드로 수행한 요청에 대한 응답으로 서비스는 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 Standard HTTP status codes를 참고하십시오. | 코드| Reason phrase| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| 성공.| | 400| Bad Request| 사용자 ID가 잘못된 형식입니다.| | 403| Forbidden| authorization 헤더에서 XUID 클레임을 구문 분석할 수 없습니다.| | 404| Not Found| 소유자의 People 목록에서 대상 사용자를 찾을 수 없습니다.|

필수 응답 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Length| 32-bit unsigned integer| 응답 본문의 길이(바이트)입니다. 예시 값: 22.| | Content-Type| string| 응답 본문의 MIME 형식입니다. 이는 항상 application/json입니다.|

응답 본문

호출이 성공하면 서비스가 대상 person을 반환합니다. Person (JSON)을 참고하십시오.

샘플 응답

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

참고 항목

상위

/users//people/

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

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

GET (/users//people/)

설명

URI 매개 변수

권한 부여

필수 요청 헤더

선택적 요청 헤더

요청 본문

HTTP 상태 코드

필수 응답 헤더

응답 본문

샘플 응답

참고 항목

상위

​GET (/users//people/)

​설명

​URI 매개 변수

​권한 부여

​필수 요청 헤더

​선택적 요청 헤더

​요청 본문

​HTTP 상태 코드

​필수 응답 헤더

​응답 본문

​샘플 응답

​참고 항목

상위

GET (/users//people/)

설명

URI 매개 변수

권한 부여

필수 요청 헤더

선택적 요청 헤더

요청 본문

HTTP 상태 코드

필수 응답 헤더

응답 본문

샘플 응답

참고 항목