GET (/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite})
현재 사용자의 알려진 모든 연락처 또는 해당 사용자가 즐겨찾는 사람으로 지정한 연락처만을 대상으로 통계 값(점수)의 순위를 매겨 소셜 리더보드를 반환합니다. 이 URI의 도메인은leaderboards.xboxlive.com입니다.
설명
리더보드 API는 모두 읽기 전용이므로 (HTTPS를 통한) GET 동사만 지원합니다. 이 API는 Player Data 시스템을 통해 기록된 개별 사용자 통계에서 파생된, 인덱싱된 플레이어 통계의 순위가 매겨지고 정렬된 “페이지”를 반영합니다. 전체 리더보드 인덱스는 매우 클 수 있으며 호출자는 절대 전체를 보기를 요청하지 않으므로, 이 URI는 호출자가 해당 리더보드에 대해 어떤 종류의 뷰를 보고자 하는지 구체적으로 지정할 수 있는 여러 쿼리 문자열 인수를 지원합니다. GET 작업은 리소스를 수정하지 않으므로 한 번 실행하든 여러 번 실행하든 동일한 결과가 생성됩니다.URI 매개변수
쿼리 문자열 매개변수
권한 부여
Xuid 권한 부여가 필요합니다. 콘텐츠 격리 및 액세스 제어 시나리오를 위한 권한 부여 로직이 구현되어 있습니다. 리더보드와 사용자 통계는 호출자가 요청과 함께 유효한 XSTS 토큰을 제출하는 한 모든 플랫폼의 클라이언트에서 읽을 수 있습니다. 쓰기는 (당연히) Player Data 시스템에서 지원하는 클라이언트로 제한됩니다. 타이틀 개발자는 Partner Center를 통해 통계를 공개 또는 제한으로 표시할 수 있습니다. 리더보드는 공개 통계입니다. 공개 통계는 사용자가 샌드박스에 대해 권한이 부여되어 있는 한 Smartglass는 물론 iOS, Android, Windows, Windows Phone 및 웹 애플리케이션에서 액세스할 수 있습니다. 사용자의 샌드박스에 대한 권한 부여는 Partner Center를 통해 관리됩니다.필수 요청 헤더
선택적 요청 헤더
요청 본문
호출자가 반환받는 데이터를 올바르게 표시할 수 있도록, 각 사용자의 각 통계 값은 표시되어야 하는 형식의 문자열로 반환되며 요청의 accept-language 헤더에 지정된 로캘에 맞게 서식이 지정됩니다. 해당 리더보드의 statname에 대한 지역화된 “표시 이름”도 반환됩니다.필수 멤버
HTTP 상태 코드
이 리소스에서 이 메서드로 이루어진 요청에 대한 응답으로 서비스는 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 표준 HTTP 상태 코드를 참조하세요.필수 응답 헤더
선택적 응답 헤더
응답 본문
페이징이 없는 소셜 리더보드 요청:https://leaderboards.xboxlive.com/users/xuid(2533274916402282)/scids/c1ba92a9-0000-0000-0000-000000000000/stats/EnemyDefeats/people/all?sort=descending
