Skip to main content

GET (/users//summary)

호출자 관점에서 소유자에 대한 요약 데이터를 가져옵니다.

URI 매개 변수

권한 부여

| 이름| 형식| 설명| | --- | --- | --- | --- | --- | --- | | xuid| 64-bit unsigned integer| 필수. 호출자의 user identifier입니다. 예시 값: 2533274790395904|

필수 요청 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| 에 대한 권한 부여 데이터입니다. 이는 일반적으로 암호화된 XSTS 토큰입니다. 예시 값: XBL3.0 x=[hash];[token].|

선택적 요청 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| string| 이 요청을 라우팅해야 하는 서비스의 빌드 이름/번호입니다. 헤더의 유효성, 인증 토큰의 클레임 등을 검증한 후에만 요청이 해당 서비스로 라우팅됩니다. 예시 값: 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 클레임을 구문 분석할 수 없습니다.|

필수 응답 헤더

| 헤더| 형식| 설명| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Length| string| 응답에서 전송되는 바이트 수입니다. 예시 값: 232.| | Content-Type| string| 응답 본문의 MIME 형식입니다. 이는 application/json이어야 합니다.|

응답 본문

PersonSummary (JSON)를 참고하십시오.

샘플 응답

참고 항목

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