POST (/batch)

Método POST que funciona como un método GET para solicitudes por lotes complejas de estadísticas de varios jugadores en varios títulos. El dominio de estos URI es userstats.xboxlive.com.

Comentarios

Los desarrolladores de títulos pueden marcar las estadísticas como abiertas o restringidas con Partner Center. Las tablas de clasificación son estadísticas abiertas. Las estadísticas abiertas son accesibles desde Smartglass, así como desde aplicaciones de iOS, Android, Windows, Windows Phone y web, siempre que el usuario esté autorizado en el sandbox. La autorización del usuario en un sandbox se administra mediante Partner Center.

Comentarios
Descripción
Autorización
Encabezados de solicitud obligatorios
Encabezados de solicitud opcionales
Cuerpo de la solicitud
Códigos de estado HTTP
Cuerpo de la respuesta

Descripción

El autor de la llamada proporciona un cuerpo de mensaje con una matriz de usuarios, identificadores de configuración de servicio (SCID) y una lista de nombres de estadísticas por SCID para los que se van a recuperar esas estadísticas. Puede resultarle más útil revisar el método GET simple de una sola estadística antes de leer esta página más compleja de modo por lotes.

Autorización

Hay lógica de autorización implementada para escenarios de aislamiento de contenido y control de acceso.

Tanto las tablas de clasificación como las estadísticas de usuario se pueden leer desde clientes de cualquier plataforma, siempre que el autor de la llamada envíe un token XSTS válido con la solicitud. Obviamente, las escrituras están limitadas a los clientes compatibles con .
Los desarrolladores de títulos pueden marcar las estadísticas como abiertas o restringidas con Partner Center. Las tablas de clasificación son estadísticas abiertas. Las estadísticas abiertas son accesibles desde Smartglass, así como desde aplicaciones de iOS, Android, Windows, Windows Phone y web, siempre que el usuario esté autorizado en el sandbox. La autorización del usuario en un sandbox se administra mediante Partner Center.

El ejemplo siguiente es pseudocódigo de la comprobación:

If (!checkAccess(serviceConfigId, resource, CLAIM[userid, deviceid, titleid]))
{
        Reject request as Unauthorized
}

// else accept request.
         

Encabezados de solicitud obligatorios

Encabezado	Tipo	Descripción
Authorization	string	Credenciales de autenticación para la autenticación HTTP. Valor de ejemplo: “XBL3.0 x=<userhash>;<token>”.

Encabezados de solicitud opcionales

| Encabezado| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| | Nombre o número de compilación del servicio al que se debe dirigir esta solicitud. La solicitud solo se enrutará a ese servicio tras comprobar la validez del encabezado, las notificaciones del token de autenticación, etc. Valor predeterminado: 1.|

Cuerpo de la solicitud

Solicitud de ejemplo

El siguiente cuerpo POST informa al servicio de que se solicitan cuatro estadísticas de dos SCID diferentes para dos usuarios 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 estado HTTP

El servicio devuelve uno de los códigos de estado de esta sección en respuesta a una solicitud realizada con este método en este recurso. Para obtener una lista completa de los códigos de estado HTTP estándar que se usan con los servicios de XBOX Live, consulte Códigos de estado HTTP estándar. | Código| Frase de motivo| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| La sesión se recuperó correctamente.| | 304| Not Modified| El recurso no se ha modificado desde la última solicitud.| | 400| Bad Request| El servicio no pudo interpretar una solicitud con formato incorrecto. Normalmente, un parámetro no válido.| | 401| Unauthorized| La solicitud requiere autenticación del usuario.| | 403| Forbidden| La solicitud no está permitida para el usuario o el servicio.| | 404| Not Found| No se pudo encontrar el recurso especificado.| | 406| Not Acceptable| No se admite la versión del recurso.| | 408| Request Timeout| No se admite la versión del recurso; la capa MVC debería rechazarla.|

Cuerpo de la respuesta

Respuesta de ejemplo

{    
   "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
             }]
          }],
                   }]
}
         

Consulte también

Elemento primario

/batch

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

POST (/batch)

POST (/batch)

Comentarios

Descripción

Autorización

Encabezados de solicitud obligatorios

Encabezados de solicitud opcionales

Cuerpo de la solicitud

Solicitud de ejemplo

Códigos de estado HTTP

Cuerpo de la respuesta

Respuesta de ejemplo

Consulte también

Elemento primario

​POST (/batch)

​Comentarios

​Descripción

​Autorización

​Encabezados de solicitud obligatorios

​Encabezados de solicitud opcionales

​Cuerpo de la solicitud

​Solicitud de ejemplo

​Códigos de estado HTTP

​Cuerpo de la respuesta

​Respuesta de ejemplo

​Consulte también

Elemento primario

POST (/batch)

Comentarios

Descripción

Autorización

Encabezados de solicitud obligatorios

Encabezados de solicitud opcionales

Cuerpo de la solicitud

Solicitud de ejemplo

Códigos de estado HTTP

Cuerpo de la respuesta

Respuesta de ejemplo

Consulte también