> ## 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)

取得 hopper 的統計資料。

> **重要：**\
> 此方法適用於合約 103 或更新版本，且每個要求都需要 X-Xbl-Contract-Version: 103 或更新版本的標頭元素。

* [備註](#ID4ET)
* [URI 參數](#ID4E5)
* [授權](#ID4EJB)
* [HTTP 狀態碼](#ID4E3C)
* [要求本文](#ID4EFD)
* [回應本文](#ID4EQD)

<a id="ID4ET" />

## 備註

此 HTTP/REST 方法會在服務設定識別碼 (SCID) 層級，從具名 hopper 取得統計資料。此方法可由 **Microsoft.Xbox.Services.Matchmaking.MatchmakingService.GetHopperStatisticsAsync** API 包裝。

<a id="ID4E5" />

## URI 參數

\| 參數| 類型| 描述|
\| --- | --- | --- | --- |
\| scid| GUID| 工作階段的服務設定識別碼 (SCID)。|
\| name| string| hopper 的名稱。|

<a id="ID4EJB" />

## 授權

\| 類型| 必要| 描述| 遺漏時的回應|
\| --- | --- | --- | --- | --- | --- | --- | --- |
\| XUID (使用者識別碼)| 是| 提出要求的使用者必須是票證所參考之票證工作階段的成員。 | 403|
\| 權限與裝置類型| 是| 當使用者的 deviceType 設定為 console 時，只有在宣告中具有多人遊戲權限的使用者，才能呼叫配對服務。 | 403|
\| 遊戲識別碼/購買證明/裝置類型| 是| 要配對進入的遊戲必須允許針對指定的遊戲宣告與裝置類型組合進行配對。 | 403|

<a id="ID4E3C" />

## HTTP 狀態碼

服務會傳回適用於 MPSD 的 HTTP 狀態碼。

<a id="ID4EFD" />

## 要求本文

此要求的本文中不會傳送任何物件。

<a id="ID4EQD" />

## 回應本文

\| 成員| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| hopperName| string| 所選 hopper 的名稱。|
\| waitTime| 32 位元帶正負號整數| hopper 的平均配對時間 (以整數秒為單位)。 |
\| population| 32 位元帶正負號整數| 在 hopper 中等候配對的人數。|

<a id="ID4E1D" />

### 範例回應

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


```

<a id="ID4EJE" />

## 另請參閱

<a id="ID4ELE" />

##### 上層

[/serviceconfigs/{scid}/hoppers/{name}/stats](/zh-TW/reference/live/rest/uri/matchtickets/uri-serviceconfigsscidhoppershoppernamestats)


## Related topics

- [XblMatchmakingGetHopperStatisticsAsync](/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakinggethopperstatisticsasync.md)
- [XblMatchmakingGetMatchTicketDetailsAsync](/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakinggetmatchticketdetailsasync.md)