GET (/users/xuid()/scids//stats)
지정된 사용자를 대신하여 쉼표로 구분된 사용자 통계 이름 목록으로 범위가 지정된 서비스 구성을 가져옵니다. 이러한 URI의 도메인은userstats.xboxlive.com입니다.
설명
클라이언트는 새로운 플레이어 통계 시스템에 대해 플레이어를 대신하여 타이틀 통계를 읽고 쓸 수 있는 방법이 필요합니다.URI 매개 변수
쿼리 문자열 매개 변수
| 매개 변수| 형식| 설명| | --- | --- | --- | --- | --- | --- | | statNames| string| 유일한 쿼리 문자열 매개 변수는 쉼표로 구분된 사용자 통계 이름 URI 명사입니다. 예를 들어 다음 URI는 URI에 지정된 사용자 ID를 대신하여 네 개의 통계를 요청한다는 것을 서비스에 알립니다.https://userstats.xboxlive.com/users/xuid({xuid})/scids/{scid}/stats/wins,kills,kdratio,headshots한 번의 호출에서 요청할 수 있는 통계 수에는 제한이 있으며, 이 제한은 개발자 편의성과 URI 길이의 실용성 간의 “최적점”을 신중하게 고려합니다. 예를 들어 제한은 통계 이름 텍스트(쉼표 포함) 기준 600자 또는 최대 10개의 통계로 결정될 수 있습니다. 이와 같은 단순한 GET을 사용하면 일반적으로 요청되는 통계에 대해 HTTP 캐싱이 가능하여 잦은 호출을 하는 클라이언트로부터의 호출량이 줄어듭니다. |
권한 부여
콘텐츠 격리 및 액세스 제어 시나리오에 대해 권한 부여 논리가 구현됩니다.- 호출자가 요청과 함께 유효한 XSTS 토큰을 제출하는 한, 순위표와 사용자 통계는 모두 모든 플랫폼의 클라이언트에서 읽을 수 있습니다. 쓰기는 명백히 Player Data 시스템에서 지원하는 클라이언트로 제한됩니다.
- 타이틀 개발자는 Partner Center를 사용하여 통계를 공개(open) 또는 제한(restricted)으로 표시할 수 있습니다. 순위표는 공개 통계입니다. 사용자가 샌드박스에 대해 권한이 부여된 경우, 공개 통계는 Smartglass는 물론 iOS, Android, Windows, Windows Phone 및 웹 애플리케이션에서 액세스할 수 있습니다. 샌드박스에 대한 사용자 권한은 Partner Center를 통해 관리됩니다.