> ## 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 (ユーザー ID)| はい| リクエストを行うユーザーは、ticket が参照する ticket セッションのメンバーである必要があります。 | 403|
\| 特権とデバイスの種類| はい| ユーザーの deviceType が console に設定されている場合、要求内に multiplayer 特権を持つユーザーのみがマッチメイキング サービスへの呼び出しを行うことができます。 | 403|
\| タイトル ID/購入証明/デバイスの種類| はい| マッチング対象のタイトルは、指定されたタイトル要求 (title claim) とデバイスの種類の組み合わせに対してマッチメイキングを許可する必要があります。 | 403|

## HTTP ステータス コード

サービスは、MPSD に対して適用される HTTP ステータス コードを返します。

## リクエスト本文

このリクエストの本文にはオブジェクトは送信されません。

## 応答本文

\| メンバー| 種類| 説明|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| hopperName| string| 選択されたホッパーの名前。|
\| waitTime| 32 ビット符号付き整数| ホッパーの平均マッチング時間 (整数秒)。 |
\| population| 32 ビット符号付き整数| ホッパーでマッチを待っている人数。|

### サンプル応答

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


```

## 関連項目

##### 親

[/serviceconfigs/{scid}/hoppers/{name}/stats](https://devdocs.xbox.com/ja-jp/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)