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
Descrição
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

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 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:

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=<userhash>;<token>”.

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.

{    
"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. | 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

{    
   "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

Porting

Build Paths

POST (/batch)

POST (/batch)

Comentários

Descrição

Autorização

Cabeçalhos de solicitação obrigatórios

Cabeçalhos de solicitação opcionais

Corpo da solicitação

Exemplo de solicitação

Códigos de status HTTP

Corpo da resposta

Exemplo de resposta

Confira também

Pai

​POST (/batch)

​Comentários

​Descrição

​Autorização

​Cabeçalhos de solicitação obrigatórios

​Cabeçalhos de solicitação opcionais

​Corpo da solicitação

​Exemplo de solicitação

​Códigos de status HTTP

​Corpo da resposta

​Exemplo de resposta

​Confira também

Pai

POST (/batch)

Comentários

Descrição

Autorização

Cabeçalhos de solicitação obrigatórios

Cabeçalhos de solicitação opcionais

Corpo da solicitação

Exemplo de solicitação

Códigos de status HTTP

Corpo da resposta

Exemplo de resposta

Confira também