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

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](#ID4ET)
* [Parámetros de URI](#ID4E5)
* [Autorización](#ID4EJB)
* [Códigos de estado HTTP](#ID4E3C)
* [Cuerpo de la solicitud](#ID4EFD)
* [Cuerpo de la respuesta](#ID4EQD)

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

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


```

## Consulte también

##### Elemento primario

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


## Related topics

- [XblMatchmakingGetHopperStatisticsAsync](https://devdocs.xbox.com/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakinggethopperstatisticsasync.md)
- [XblMatchmakingGetMatchTicketDetailsAsync](https://devdocs.xbox.com/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakinggetmatchticketdetailsasync.md)