> ## 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. # POST (/batch) > POST (/batch) # POST (/batch) Método POST que funciona como um método GET para solicitações em lote complexas para várias estatísticas de jogadores em vários títulos. O domínio desses URIs é `userstats.xboxlive.com`. ## Comentários 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. * [Comentários](#ID4ET) * [Descrição](#ID4EFB) * [Autorização](#ID4EUB) * [Cabeçalhos de solicitação obrigatórios](#ID4ETC) * [Cabeçalhos de solicitação opcionais](#ID4E3D) * [Corpo da solicitação](#ID4EAF) * [Códigos de status HTTP](#ID4EWF) * [Corpo da resposta](#ID4ENBAC) ## Descrição O chamador fornece um corpo de mensagem com uma matriz de usuários, IDs de configuração de serviço (SCIDs) e uma lista de nomes de estatísticas por SCID para os quais essas estatísticas serão recuperadas. Talvez seja mais útil examinar o método [GET](/pt-BR/reference/live/rest/uri/userstats/uri-usersxuidscidsscidstatsget) simples, de estatística única, antes de ler esta página mais complexa, em modo de lote. ## 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 . * 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 exemplo a seguir é um pseudocódigo para a verificação: ```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 ### Exemplo de solicitação o corpo POST a seguir informa ao serviço que quatro estatísticas estão sendo solicitadas de dois SCIDs diferentes para dois usuários diferentes. ```cpp theme={null} { "requestedusers": [ 1234567890123460, 1234567890123234 ], "requestedscids": [ { "scid": "c402ff50-3e76-11e2-a25f-0800200c1212", "requestedstats": [ "Test4FirefightKills", "Test4FirefightHeadshots" ] }, { "scid": "c402ff50-3e76-11e2-a25f-0800200c0343", "requestedstats": [ "OverallTestKills", "TestHeadshots" ] } ] } ``` ## 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} { "users":[ { "xuid": "123456789" "gamertag": "WarriorSaint", "scids":[ { "scid":"c402ff50-3e76-11e2-a25f-0800200c1212", "stats": [ { "statname":"Test4FirefightKills", "type":"Integer", "value":7 }, { "statname":"Test4FirefightHeadshots", "type":"Integer", "value":4 }] }, { "scid":"c402ff50-3e76-11e2-a25f-0800200c0343", "stats": [ { "statname":"OverallTestKills", "type":"Integer", "value":3434 }, { "statname":"TestHeadshots", "type":"Integer", "value":41 }] }], }, { "gamertag":"TigerShark", "xuid":1234567890123234 "scids":[ { "scid":"123456789", "stats": [ { "statname":"Test4FirefightKills", "type":"Integer", "value":63 }, { "statname":"Test4FirefightHeadshots", "type":"Integer", "value":12 }] }, { "scid":"987654321", "stats": [ { "statname":"OverallTestKills", "type":"Integer", "value":375 }, { "statname":"TestHeadshots", "type":"Integer", "value":34 }] }], }] } ``` ## Confira também ##### Pai [/batch](/pt-BR/reference/live/rest/uri/userstats/uri-batch) ## Related topics - [XblUserStatisticsGetMultipleUserStatisticsAsync](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsasync.md) - [XblUserStatisticsGetMultipleUserStatisticsForMultipleServiceConfigurationsAsync](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsformultipleserviceconfigurationsasync.md)