> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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)

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)

## 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**.

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

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

## Codes d'état HTTP

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

## Corps de la requête

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

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

### Exemple de réponse

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


```

## Voir aussi

### Parent

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


## Related topics

- [/serviceconfigs/{scid}/hoppers/{name}/stats](https://docs.xbox.com/fr-CA/reference/live/rest/uri/matchtickets/uri-serviceconfigsscidhoppershoppernamestats.md)
- [GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName})](https://docs.xbox.com/fr-CA/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenameget.md)
- [GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions)](https://docs.xbox.com/fr-CA/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionsget.md)
- [GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})](https://docs.xbox.com/fr-CA/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionnameget.md)
- [XblMatchmakingGetHopperStatisticsAsync](https://docs.xbox.com/fr-CA/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakinggethopperstatisticsasync.md)