GET(/users/xuid({xuid})/scids/{scid}/stats)

아티클
05/10/2023

지정된 사용자를 대신하여 쉼표로 구분된 사용자 통계 이름 목록으로 범위가 지정된 서비스 구성을 가져옵니다. 이 URI의 도메인은 userstats.xboxlive.com입니다.

비고
URI 매개 변수
쿼리 문자열 매개 변수
Authorization
필수 요청 헤더
선택적 요청 헤더
요청 본문
HTTP 상태 코드
응답 본문

설명

클라이언트는 새로운 플레이어 통계 시스템에서 플레이어를 대신하여 타이틀 통계를 읽고 쓰는 방법이 필요합니다.

URI 매개 변수

매개 변수	형식	설명
xuid	GUID	서비스 구성에 액세스하려는 사용자의 Xbox 사용자 ID(XUID)입니다.
scid	GUID	액세스되는 리소스를 포함하는 서비스 구성 식별자입니다.

쿼리 문자열 매개 변수

매개 변수	형식	설명
statNames	문자열	유일한 쿼리 문자열 매개 변수는 쉼표로 구분된 사용자 통계 이름 URI 명사입니다. 예를 들어 다음 URI는 해당 URI에 지정된 사용자 ID 대신 네 개의 통계가 요청되었음을 서비스에 알립니다. `https://userstats.xboxlive.com/users/xuid({xuid})/scids/{scid}/stats/wins,kills,kdratio,headshots`단일 호출에서 요청할 수 있는 통계의 수에는 제한이 있으며, 이 제한은 개발자의 편의성과 URI 길이의 실용성을 비교하여 "최적의 지점"을 신중하게 고려합니다. 예를 들어 제한은 600자의 통계 이름 텍스트(쉼표 포함) 또는 최대 10개의 통계로 결정될 수 있습니다. 이와 같이 간단한 GET를 활성화하면 일반적으로 요청되는 통계에 대한 HTTP 캐싱이 활성화되면서 활발한 클라이언트의 호출량을 줄입니다.

Authorization

콘텐츠 격리 및 액세스 제어 시나리오에 대해 구현된 권한 부여 논리가 있습니다.

호출자가 요청과 함께 유효한 XSTS 토큰을 제출하는 경우 모든 플랫폼의 클라이언트에서 순위표와 사용자 통계를 모두 읽을 수 있습니다. 쓰기는 플레이어 데이터 시스템에서 지원하는 클라이언트로 제한됩니다.
타이틀 개발자는 파트너 센터에서 통계를 공개 또는 제한으로 표시할 수 있습니다. 순위표는 공개된 통계입니다. 사용자가 샌드박스에 대한 권한이 있는 한 공개된 통계는 Smartglass뿐만 아니라 iOS, Android, Windows, Windows Phone 및 웹 애플리케이션을 통해 액세스할 수 있습니다. 샌드박스에 대한 사용자 권한 부여는 파트너 센터를 통해 관리됩니다.

검사에 대한 의사 코드는 다음과 같습니다.

If (!checkAccess(serviceConfigId, resource, CLAIM[userid, deviceid, titleid]))
{
        Reject request as Unauthorized
}

// else accept request.

필수 요청 헤더

헤더	형식	설명
Authorization	문자열	HTTP 인증을 위한 인증 자격 증명입니다. 예제 값: "XBL3.0 x=<userhash>;<token>".

선택적 요청 헤더

헤더	형식	설명
X-RequestedServiceVersion		이 요청을 연결해야 하는 서비스의 이름/번호를 작성합니다. 헤더의 유효성과 인증 토큰의 클레임 등을 확인한 이후에만 요청이 해당 서비스로 라우팅됩니다. 기본값: 1.

요청 본문

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

HTTP 상태 코드

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

코드	이유 구문	설명
200	OK	세션이 성공적으로 검색되었습니다.
304	Not Modified	마지막으로 요청한 이후로 리소스가 수정되지 않았습니다.
400	Bad Request	서비스가 형식이 잘못된 요청을 이해할 수 없습니다. 일반적으로 잘못된 매개 변수입니다.
401	Unauthorized	요청에 대해 사용자 인증이 필요합니다.
403	Forbidden	사용자 또는 서비스에 대해 요청이 허용되지 않습니다.
404	Not Found	지정된 리소스를 찾을 수 없습니다.
406	Not Acceptable	리소스 버전이 지원되지 않습니다.
408	Request Timeout	리소스 버전은 지원되지 않습니다. MVC 계층에서 거부되어야 합니다.

응답 본문

샘플 응답

{
    "user": {
    "xuid": "123456789",
        "gamertag": "WarriorSaint",
        "stats": [
            {
                "statname": "Wins",
                "type": "Integer",
                "value": 40
            },
            {
                "statname": "Kills",
                "type": "Integer",
                "value": 700
            },
            {
                "statname": "KDRatio",
                "type": "Double",
                "value": 2.23
            },
            {
                "statname": "Headshots",
                "type": "Integer",
                "value": 173
            }
        ],
    }
}

참고 항목

부모

/users/xuid({xuid})/scids/{scid}/stats

다음을 통해 공유