> ## 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 (/serviceconfigs/{scid}/hoppers/{name}/stats)

> GET (/serviceconfigs/{scid}/hoppers/{name}/stats)

# GET (/serviceconfigs/{scid}/hoppers/{name}/stats)

호퍼에 대한 통계를 가져옵니다.

> **중요:**\
> 이 메서드는 contract 103 이상에서 사용하도록 되어 있으며, 모든 요청에서 X-Xbl-Contract-Version: 103 이상의 헤더 요소가 필요합니다.

* [설명](#ID4ET)
* [URI 매개 변수](#ID4E5)
* [권한 부여](#ID4EJB)
* [HTTP 상태 코드](#ID4E3C)
* [요청 본문](#ID4EFD)
* [응답 본문](#ID4EQD)

## 설명

이 HTTP/REST 메서드는 서비스 구성 ID(SCID) 수준에서 지정된 이름의 호퍼로부터 통계를 가져옵니다. 이 메서드는 **Microsoft.Xbox.Services.Matchmaking.MatchmakingService.GetHopperStatisticsAsync** API로 래핑할 수 있습니다.

## URI 매개 변수

\| 매개 변수| 형식| 설명|
\| --- | --- | --- | --- |
\| scid| GUID| 세션에 대한 서비스 구성 식별자(SCID)입니다.|
\| name| string| 호퍼의 이름입니다.|

## 권한 부여

\| 형식| 필수| 설명| 누락 시 응답|
\| --- | --- | --- | --- | --- | --- | --- | --- |
\| XUID (user ID)| 예| 요청을 하는 사용자는 티켓이 참조하는 티켓 세션의 구성원이어야 합니다. | 403|
\| Privileges and Device Type| 예| 사용자의 deviceType이 console로 설정된 경우, 클레임에 multiplayer 권한이 있는 사용자만 매치메이킹 서비스에 대한 호출을 수행할 수 있습니다. | 403|
\| Title ID/Proof of Purchase/Device Type| 예| 매칭 대상 타이틀은 지정된 title claim, device type 조합에 대해 매치메이킹을 허용해야 합니다. | 403|

## HTTP 상태 코드

서비스는 MPSD에 적용되는 HTTP 상태 코드를 반환합니다.

## 요청 본문

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

## 응답 본문

\| 멤버| 형식| 설명|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| hopperName| string| 선택된 호퍼의 이름입니다.|
\| waitTime| 32-bit signed integer| 호퍼에 대한 평균 매칭 시간(정수 초 단위)입니다. |
\| population| 32-bit signed integer| 호퍼에서 매치를 기다리고 있는 사람의 수입니다.|

### 샘플 응답

```cpp theme={null}
{
      "hopperName":"contosoawesome2",
      "waitTime":30,
      "population":1
    }


```

## 참고 항목

##### 상위

[/serviceconfigs/{scid}/hoppers/{name}/stats](https://devdocs.xbox.com/ko/reference/live/rest/uri/matchtickets/uri-serviceconfigsscidhoppershoppernamestats)


## Related topics

- [XblMatchmakingGetHopperStatisticsAsync](https://devdocs.xbox.com/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakinggethopperstatisticsasync.md)
- [XblMatchmakingGetMatchTicketDetailsAsync](https://devdocs.xbox.com/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakinggetmatchticketdetailsasync.md)