Skip to main content

​
GET (/users//people/)

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

​
설명

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

​
URI 매개 변수

​
권한 부여

| 형식| 필수| 설명| 누락 시 응답| | --- | --- | --- | --- | --- | --- | --- | | 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)을 참고하십시오.

​
샘플 응답

​
참고 항목

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