Skip to main content

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

Obtiene las estadísticas de un hopper.
Importante:
Este método está pensado para usarse con el contrato 103 o posterior, y requiere un elemento de encabezado X-Xbl-Contract-Version: 103 o posterior en cada solicitud.

​
Comentarios

Este método HTTP/REST obtiene estadísticas del hopper con nombre en el nivel de identificador de configuración de servicio (SCID). Este método se puede encapsular mediante la API Microsoft.Xbox.Services.Matchmaking.MatchmakingService.GetHopperStatisticsAsync.

​
Parámetros de URI

| Parámetro| Tipo| Descripción| | --- | --- | --- | --- | | scid| GUID| El identificador de configuración de servicio (SCID) de la sesión.| | name| string| El nombre del hopper.|

​
Autorización

| Tipo| Obligatorio| Descripción| Respuesta si falta| | --- | --- | --- | --- | --- | --- | --- | --- | | XUID (identificador de usuario)| sí| El usuario que realiza la solicitud debe ser miembro de la sesión de vale a la que hace referencia el vale. | 403| | Privilegios y tipo de dispositivo| sí| Cuando el deviceType del usuario está establecido en console, solo los usuarios con el privilegio multiplayer en sus notificaciones pueden realizar llamadas al servicio de emparejamiento. | 403| | Identificador de título/Prueba de compra/Tipo de dispositivo| sí| El título en el que se realiza el emparejamiento debe permitir el emparejamiento para la combinación de notificación de título y tipo de dispositivo especificada. | 403|

​
Códigos de estado HTTP

El servicio devuelve un código de estado HTTP tal como se aplica a MPSD.

​
Cuerpo de la solicitud

No se envía ningún objeto en el cuerpo de esta solicitud.

​
Cuerpo de la respuesta

| Miembro| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | hopperName| string| El nombre del hopper seleccionado.| | waitTime| Entero de 32 bits con signo| Tiempo medio de emparejamiento del hopper (un número entero de segundos). | | population| Entero de 32 bits con signo| El número de personas que esperan emparejamientos en el hopper.|

​
Ejemplo de respuesta

​
Consulte también

Elemento primario
/serviceconfigs//hoppers//stats
Last modified on October 19, 2026