Skip to main content

​
GET (/serviceconfigs//hoppers//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

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

​
Confira também

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