Pular para o conteúdo principal

GET (/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite})

Retorna um placar de líderes social classificando os valores de estatística (pontuações) de todos os contatos conhecidos do usuário atual ou somente dos contatos designados como pessoas favoritas por esse usuário. O domínio desses URIs é leaderboards.xboxlive.com.

Comentários

As APIs de placar de líderes são todas somente leitura e, portanto, só oferecem suporte ao verbo GET (por HTTPS). Elas refletem “páginas” classificadas e ordenadas de estatísticas de jogadores indexadas, derivadas de estatísticas individuais de usuários que foram gravadas por meio do sistema Player Data. Índices completos de placares de líderes podem ser bem grandes, e os chamadores nunca pedirão para ver um em sua totalidade; portanto, este URI oferece suporte a vários argumentos de cadeia de caracteres de consulta que permitem que um chamador especifique que tipo de exibição deseja ver desse placar de líderes. As operações GET não modificam nenhum recurso; portanto, isso produzirá os mesmos resultados se executado uma vez ou várias vezes.

Parâmetros de URI

Parâmetros da cadeia de caracteres de consulta

Autorização

A autorização por xuid é obrigatória. Há uma lógica de autorização implementada para cenários de isolamento de conteúdo e controle de acesso. Tanto os placares de líderes quanto as estatísticas de usuário podem ser lidos de clientes em qualquer plataforma, desde que o chamador envie um token XSTS válido com a solicitação. As gravações, obviamente, são limitadas aos clientes compatíveis com o sistema Player Data. Os desenvolvedores de títulos podem marcar estatísticas como abertas ou restritas com o Partner Center. Os placares de líderes são estatísticas abertas. As estatísticas abertas podem ser acessadas pelo Smartglass, bem como por aplicativos iOS, Android, Windows, Windows Phone e Web, desde que o usuário esteja autorizado na área restrita. A autorização do usuário em uma área restrita é gerenciada por meio do Partner Center.

Cabeçalhos de solicitação obrigatórios

Cabeçalhos de solicitação opcionais

Corpo da solicitação

Para maximizar a capacidade de qualquer chamador de entender os dados que recebe para exibi-los corretamente, cada valor de estatística de cada usuário será retornado como uma cadeia de caracteres no formato em que deve ser exibido e formatado de acordo com a localidade especificada no cabeçalho accept-language da solicitação. Um “nome de exibição” localizado também será retornado para o statname desse placar de líderes.

Membros obrigatórios

Códigos de status HTTP

O serviço retorna um dos códigos de status desta seção em resposta a uma solicitação feita com este método neste recurso. Para obter uma lista completa dos códigos de status HTTP padrão usados com os XBOX Live Services, confira Códigos de status HTTP padrão.

Cabeçalhos de resposta obrigatórios

Cabeçalhos de resposta opcionais

Corpo da resposta

Solicitação de placar de líderes social, sem paginação: https://leaderboards.xboxlive.com/users/xuid(2533274916402282)/scids/c1ba92a9-0000-0000-0000-000000000000/stats/EnemyDefeats/people/all?sort=descending

Exemplo de resposta

Confira também

/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite}
Última modificação em 5 de novembro de 2026