> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

* [설명](#ID4EV)
* [URI 매개 변수](#ID4EEB)
* [쿼리 문자열 매개 변수](#ID4EPB)
* [권한 부여](#ID4EUC)
* [필수 요청 헤더](#ID4EPD)
* [선택적 요청 헤더](#ID4EYE)
* [요청 본문](#ID4E3F)
* [HTTP 상태 코드](#ID4EHG)
* [응답 본문](#ID4E5BAC)

## 설명

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

## URI 매개 변수

| 매개 변수 | 형식 | 설명 |
| - | - | - |
| xuid | GUID | 서비스 구성에 액세스할 대상 사용자의 XBOX User ID(XUID)입니다. |
| scid | GUID | 액세스할 리소스를 포함하는 서비스 구성의 식별자입니다. |

## 쿼리 문자열 매개 변수

\| 매개 변수| 형식| 설명|
\| --- | --- | --- | --- | --- | --- |
\| 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를 통해 관리됩니다.

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

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

// else accept request.

```

## 필수 요청 헤더

\| 헤더| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| HTTP 인증에 대한 인증 자격 증명입니다. 예시 값: “XBL3.0 x=\<userhash>;\<token>”.|

## 선택적 요청 헤더

\| 헤더| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| X-RequestedServiceVersion|  | 이 요청을 라우팅해야 하는 서비스의 빌드 이름/번호입니다. 헤더의 유효성, 인증 토큰의 클레임 등을 검증한 후에만 요청이 해당 서비스로 라우팅됩니다. 기본값: 1.|

## 요청 본문

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

## HTTP 상태 코드

이 리소스에서 이 메서드로 수행한 요청에 대한 응답으로 서비스는 이 섹션의 상태 코드 중 하나를 반환합니다. XBOX Live Services에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 [Standard HTTP status codes](/ko/reference/live/rest/additional/httpstatuscodes)를 참고하십시오.

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

## 응답 본문

### 샘플 응답

```cpp theme={null}
{
    "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](/ko/reference/live/rest/uri/userstats/uri-usersxuidscidsscidstats)


## Related topics

- [Event-based Leaderboards overview](/services/xbox-services/player-data/stats-leaderboards/event-based/live-leaderboards-eb-overview.md)
- [Visão geral dos leaderboards baseados em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/live-leaderboards-eb-overview.md)
- [XblUserStatisticsGetSingleUserStatisticAsync](/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md)
- [XblUserStatisticsGetSingleUserStatisticsAsync](/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsasync.md)