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
- Parâmetros de URI
- Parâmetros da cadeia de caracteres de consulta
- Autorização
- Cabeçalhos de solicitação obrigatórios
- Cabeçalhos de solicitação opcionais
- Corpo da solicitação
- Códigos de status HTTP
- Cabeçalhos de resposta obrigatórios
- Cabeçalhos de resposta opcionais
- Corpo da resposta
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
