> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # GET (/users/xuid({xuid})/scids/{scid}/stats) > GET (/users/xuid({xuid})/scids/{scid}/stats) # GET (/users/xuid({xuid})/scids/{scid}/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](#ID4EV) * [Parâmetros de URI](#ID4EEB) * [Parâmetros da cadeia de consulta](#ID4EPB) * [Autorização](#ID4EUC) * [Cabeçalhos de solicitação obrigatórios](#ID4EPD) * [Cabeçalhos de solicitação opcionais](#ID4EYE) * [Corpo da solicitação](#ID4E3F) * [Códigos de status HTTP](#ID4EHG) * [Corpo da resposta](#ID4E5BAC) ## 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âmetro | Tipo | Descrição | | - | - | - | | xuid | GUID | ID de usuário do XBOX (XUID) do usuário em cujo nome a configuração de serviço será acessada. | | scid | GUID | Identificador da configuração de serviço que contém o recurso que está sendo acessado. | ## 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,headshots`Haverá 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. O pseudocódigo da verificação é semelhante a este: ```cpp theme={null} If (!checkAccess(serviceConfigId, resource, CLAIM[userid, deviceid, titleid])) { Reject request as Unauthorized } // else accept request. ``` ## Cabeçalhos de solicitação obrigatórios \| Cabeçalho| Tipo| Descrição| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | \| Authorization| string| Credenciais de autenticação para autenticação HTTP. Valor de exemplo: "XBL3.0 x=\;\".| ## Cabeçalhos de solicitação opcionais \| Cabeçalho| Tipo| Descrição| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| X-RequestedServiceVersion| | Nome/número de build do serviço para o qual esta solicitação deve ser direcionada. A solicitação só será roteada para esse serviço após a verificação da validade do cabeçalho, das declarações no token de autenticação e assim por diante. Valor padrão: 1.| ## Corpo da solicitação Nenhum objeto é enviado no corpo desta solicitação. ## Códigos de status HTTP O serviço retorna um dos códigos de status nesta 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, consulte [Códigos de status HTTP padrão](/pt-BR/reference/live/rest/additional/httpstatuscodes). \| Código| Frase de motivo| Descrição| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| 200| OK| A sessão foi recuperada com êxito.| \| 304| Not Modified| O recurso não foi modificado desde a última solicitação.| \| 400| Bad Request| O serviço não conseguiu entender a solicitação malformada. Normalmente, um parâmetro inválido.| \| 401| Unauthorized| A solicitação requer autenticação de usuário.| \| 403| Forbidden| A solicitação não é permitida para o usuário ou serviço.| \| 404| Not Found| O recurso especificado não pôde ser encontrado.| \| 406| Not Acceptable| A versão do recurso não é compatível.| \| 408| Request Timeout| A versão do recurso não é compatível; deve ser rejeitada pela camada MVC.| ## Corpo da resposta ### Exemplo de resposta ```cpp theme={null} { "user": { "xuid": "123456789", "gamertag": "WarriorSaint", "stats": [ { "statname": "Wins", "type": "Integer", "value": 40 }, { "statname": "Kills", "type": "Integer", "value": 700 }, { "statname": "KDRatio", "type": "Double", "value": 2.23 }, { "statname": "Headshots", "type": "Integer", "value": 173 } ], } } ``` ## Confira também ##### Pai [/users/xuid({xuid})/scids/{scid}/stats](/pt-BR/reference/live/rest/uri/userstats/uri-usersxuidscidsscidstats) ## Related topics - [Event-based Leaderboards overview](/services/xbox-services/player-data/stats-leaderboards/event-based/live-leaderboards-eb-overview.md) - [XblUserStatisticsGetSingleUserStatisticsAsync](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsasync.md) - [XblUserStatisticsGetSingleUserStatisticAsync](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md)