Skip to main content

​
GET (/serviceconfigs//hoppers//stats)

Obtient les statistiques d’un 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 sur chaque requête.

​
Remarques

Cette méthode HTTP/REST obtient les statistiques du hopper nommé 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| Identificateur de configuration de service (SCID) de la session.| | name| string| Nom du hopper.|

​
Autorisation

| Type| Obligatoire| Description| Réponse en cas d’absence| | --- | --- | --- | --- | --- | --- | --- | --- | | XUID (ID utilisateur)| oui| L’utilisateur qui effectue la requête doit être membre de la session de ticket référencée par le ticket. | 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 à appeler le service de matchmaking. | 403| | ID de titre/preuve d’achat/type d’appareil| oui| Le titre dans lequel la mise en correspondance a lieu 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 renvoie 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| string| Nom du hopper sélectionné.| | waitTime| entier signé 32 bits| Temps moyen de mise en correspondance pour le hopper (nombre entier de secondes). | | population| entier signé 32 bits| Nombre de personnes en attente de correspondances dans le hopper.|

​
Exemple de réponse

​
Voir aussi

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