GET (/users/xuid()/scids//stats)
Obtém uma configuração de serviço com escopo definido por uma lista delimitada por vírgulas de nomes de estatísticas de usuário em nome do usuário especificado. O domínio desses URIs éuserstats.xboxlive.com.
- Comentários
- Parâmetros de URI
- Parâmetros da cadeia 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
- Corpo da resposta
Comentários
os clientes precisam de uma maneira de ler e gravar estatísticas de títulos em nome dos jogadores em nosso novo sistema de estatísticas de jogadores.Parâmetros de URI
Parâmetros da cadeia de consulta
| Parâmetro| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | | statNames| string| O único parâmetro da cadeia de consulta é o substantivo de URI com nomes de estatísticas de usuário delimitados por vírgulas.Por exemplo, o URI a seguir informa ao serviço que quatro estatísticas são solicitadas em nome da ID de usuário especificada no URI.https://userstats.xboxlive.com/users/xuid({xuid})/scids/{scid}/stats/wins,kills,kdratio,headshotsHaverá um limite para o número de estatísticas que podem ser solicitadas em uma única chamada, e esse limite considerará cuidadosamente um “ponto ideal” entre a conveniência do desenvolvedor e a praticidade do comprimento do URI. Por exemplo, o limite pode ser determinado por 600 caracteres de texto de nomes de estatísticas (incluindo as vírgulas) ou por no máximo 10 estatísticas. Habilitar um GET simples como este permite o cache HTTP para estatísticas solicitadas com frequência, o que reduz o volume de chamadas de clientes que fazem muitas solicitações. |
Autorização
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 por 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.