> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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)

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)

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

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

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

## Códigos de status HTTP

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

## Corpo da solicitação

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

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

### Resposta de exemplo

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


```

## Confira também

### Pai

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


## Related topics

- [/serviceconfigs/{scid}/hoppers/{name}/stats](https://docs.xbox.com/pt-BR/reference/live/rest/uri/matchtickets/uri-serviceconfigsscidhoppershoppernamestats.md)
- [GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName})](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenameget.md)
- [GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions)](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionsget.md)
- [GET (/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName})](https://docs.xbox.com/pt-BR/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionnameget.md)
- [XblMatchmakingGetHopperStatisticsAsync](https://docs.xbox.com/pt-BR/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakinggethopperstatisticsasync.md)