다음을 통해 공유

GET (/users/{ownerId}/summary)

  • 아티클

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

URI 매개 변수

매개 변수 형식 설명
ownerId 문자열 리소스에 액세스하는 사용자의 식별자입니다. 가능한 값은 "me", xuid({xuid}) 또는 gt({gamertag})입니다. 예제 값: me, xuid(2603643534573581), gt(SomeGamertag)

Authorization

이름 Type Description
xuid 64비트 부호 없는 정수 필수. 호출자의 사용자 식별자. 예제 값: 2533274790395904

필수 요청 헤더

헤더 유형 설명
Authorization 문자열 인증 데이터. 일반적으로 암호화된 XSTS 토큰입니다. 예제 값: XBL3.0 x=[hash];[token].

선택적 요청 헤더

헤더 유형 설명
x-xbl-contract-version 문자열 이 요청을 연결해야 하는 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 권한 부여 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 예제 값은 1입니다.
수락 문자열 허용 가능한 콘텐츠-유형입니다. 모든 응답은 application/json입니다.

요청 본문

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

HTTP 상태 코드

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

코드 이유 구문 설명
200 OK 세션이 성공적으로 검색되었습니다.
400 Bad Request 사용자 ID가 잘못된 형식입니다.
403 Forbidden XUID 클레임을 권한 부여 헤더에서 구문 분석할 수 없습니다.

필수 응답 헤더

헤더 유형 설명
Content-Length 문자열 응답에서 전송되는 바이트 수입니다. 예제 값: 232.
콘텐츠-종류 문자열 응답 본문의 MIME 유형. application/json이어야 합니다.

응답 본문

PersonSummary(JSON)를 참조하세요.

샘플 응답

{
    "targetFollowingCount": 87,
    "targetFollowerCount": 19,
    "isCallerFollowingTarget": true,
    "isTargetFollowingCaller": false,
    "hasCallerMarkedTargetAsFavorite": true,
    "hasCallerMarkedTargetAsKnown": true,
    "legacyFriendStatus": "None",
    "recentChangeCount": 5,
    "watermark": "5246775845000319351"
}

참고 항목

부모

/users/{ownerId}/summary