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

Obtém as estatísticas de um hopper.

> **Importante:**\
> Este método destina-se ao uso com o contrato 103 ou posterior e requer um elemento de cabeçalho X-Xbl-Contract-Version: 103 ou posterior em todas as solicitações.

* [Comentários](#ID4ET)
* [Parâmetros de URI](#ID4E5)
* [Autorização](#ID4EJB)
* [Códigos de status HTTP](#ID4E3C)
* [Corpo da solicitação](#ID4EFD)
* [Corpo da resposta](#ID4EQD)

<a id="ID4ET" />

## Comentários

Este método HTTP/REST obtém estatísticas do hopper nomeado no nível da ID de configuração do serviço (SCID). Este método pode ser encapsulado pela API **Microsoft.Xbox.Services.Matchmaking.MatchmakingService.GetHopperStatisticsAsync**.

<a id="ID4E5" />

## Parâmetros de URI

\| Parâmetro| Tipo| Descrição|
\| --- | --- | --- | --- |
\| scid| GUID| O identificador de configuração do serviço (SCID) da sessão.|
\| name| string| O nome do hopper.|

<a id="ID4EJB" />

## Autorização

\| Tipo| Obrigatório| Descrição| Resposta se ausente|
\| --- | --- | --- | --- | --- | --- | --- | --- |
\| XUID (ID de usuário)| sim| O usuário que faz a solicitação deve ser membro da sessão do tíquete referenciada pelo tíquete. | 403|
\| Privilégios e tipo de dispositivo| sim| Quando o deviceType do usuário está definido como console, somente usuários com o privilégio de multijogador em suas declarações têm permissão para fazer chamadas ao serviço de matchmaking. | 403|
\| ID do título/Comprovante de compra/Tipo de dispositivo| sim| O título no qual a correspondência está sendo feita deve permitir o matchmaking para a combinação especificada de declaração de título e tipo de dispositivo. | 403|

<a id="ID4E3C" />

## Códigos de status HTTP

O serviço retorna um código de status HTTP conforme se aplica ao MPSD.

<a id="ID4EFD" />

## Corpo da solicitação

Nenhum objeto é enviado no corpo desta solicitação.

<a id="ID4EQD" />

## Corpo da resposta

\| Membro| Tipo| Descrição|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| hopperName| string| O nome do hopper selecionado.|
\| waitTime| inteiro com sinal de 32 bits| Tempo médio de correspondência do hopper (um número inteiro de segundos). |
\| population| inteiro com sinal de 32 bits| O número de pessoas aguardando correspondências no hopper.|

<a id="ID4E1D" />

### Resposta de exemplo

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


```

<a id="ID4EJE" />

## Confira também

<a id="ID4ELE" />

##### Pai

[/serviceconfigs/{scid}/hoppers/{name}/stats](/pt-BR/reference/live/rest/uri/matchtickets/uri-serviceconfigsscidhoppershoppernamestats)


## Related topics

- [XblMatchmakingGetHopperStatisticsAsync](/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakinggethopperstatisticsasync.md)
- [XblMatchmakingGetMatchTicketDetailsAsync](/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakinggetmatchticketdetailsasync.md)