Skip to main content

​
GET (/serviceconfigs//hoppers//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

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

​
Voir aussi

Parent
/serviceconfigs//hoppers//stats
Last modified on October 6, 2026