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

Obtient les statistiques d'une trémie (hopper).

> **Important :**\
> Cette méthode est destinée à être utilisée avec le contrat 103 ou ultérieur et nécessite un élément d'en-tête X-Xbl-Contract-Version: 103 ou ultérieur dans chaque requête.

* [Remarques](#ID4ET)
* [Paramètres d'URI](#ID4E5)
* [Autorisation](#ID4EJB)
* [Codes d'état HTTP](#ID4E3C)
* [Corps de la requête](#ID4EFD)
* [Corps de la réponse](#ID4EQD)

<a id="ID4ET" />

## Remarques

Cette méthode HTTP/REST obtient les statistiques de la trémie (hopper) nommée au niveau de l'ID de configuration de service (SCID). Cette méthode peut être encapsulée par l'API **Microsoft.Xbox.Services.Matchmaking.MatchmakingService.GetHopperStatisticsAsync**.

<a id="ID4E5" />

## Paramètres d'URI

\| Paramètre| Type| Description|
\| --- | --- | --- | --- |
\| scid| GUID| L'identificateur de configuration de service (SCID) de la session.|
\| name| chaîne| Le nom de la trémie (hopper).|

<a id="ID4EJB" />

## Autorisation

\| Type| Obligatoire| Description| Réponse si absent|
\| --- | --- | --- | --- | --- | --- | --- | --- |
\| XUID (ID d'utilisateur)| oui| L'utilisateur qui effectue la requête doit être membre de la session de ticket à laquelle le ticket fait référence. | 403|
\| Privilèges et type d'appareil| oui| Lorsque le deviceType de l'utilisateur est défini sur console, seuls les utilisateurs disposant du privilège multijoueur dans leurs revendications sont autorisés à effectuer des appels au service de matchmaking. | 403|
\| ID de titre/Preuve d'achat/Type d'appareil| oui| Le titre dans lequel le jumelage s'effectue doit autoriser le matchmaking pour la combinaison de revendication de titre et de type d'appareil spécifiée. | 403|

<a id="ID4E3C" />

## Codes d'état HTTP

Le service retourne un code d'état HTTP tel qu'il s'applique au MPSD.

<a id="ID4EFD" />

## Corps de la requête

Aucun objet n'est envoyé dans le corps de cette requête.

<a id="ID4EQD" />

## Corps de la réponse

\| Membre| Type| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| hopperName| chaîne| Le nom de la trémie (hopper) sélectionnée.|
\| waitTime| entier signé 32 bits| Temps de jumelage moyen pour la trémie (nombre entier de secondes). |
\| population| entier signé 32 bits| Le nombre de personnes en attente de matchs dans la trémie.|

<a id="ID4E1D" />

### Exemple de réponse

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


```

<a id="ID4EJE" />

## Voir aussi

<a id="ID4ELE" />

##### Parent

[/serviceconfigs/{scid}/hoppers/{name}/stats](/fr-CA/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)
- [XblMultiplayerSessionReferenceUri](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreferenceuri.md)
- [XblHopperStatisticsResponse](/reference/live/xsapi-c/matchmaking_c/structs/xblhopperstatisticsresponse.md)