GET (/users/xuid()/scids//stats)
Obtiene una configuración de servicio delimitada por una lista separada por comas de nombres de estadísticas de usuario en nombre del usuario especificado. El dominio de estos URI esuserstats.xboxlive.com.
- Comentarios
- Parámetros de URI
- Parámetros de cadena de consulta
- Autorización
- Encabezados de solicitud obligatorios
- Encabezados de solicitud opcionales
- Cuerpo de la solicitud
- Códigos de estado HTTP
- Cuerpo de la respuesta
Comentarios
Los clientes necesitan una manera de leer y escribir estadísticas de título en nombre de los jugadores en nuestro nuevo sistema de estadísticas de jugador.Parámetros de URI
Parámetros de cadena de consulta
| Parámetro| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | | statNames| string| El único parámetro de cadena de consulta es el nombre de URI de estadísticas de usuario delimitadas por comas.Por ejemplo, el siguiente URI informa al servicio de que se solicitan cuatro estadísticas en nombre del identificador de usuario especificado en el URI.https://userstats.xboxlive.com/users/xuid({xuid})/scids/{scid}/stats/wins,kills,kdratio,headshotsHabrá un límite en el número de estadísticas que se pueden solicitar en una sola llamada, y ese límite tendrá muy en cuenta un “punto óptimo” entre la comodidad para el desarrollador y la practicidad de la longitud del URI. Por ejemplo, el límite podría determinarse por 600 caracteres de texto de nombres de estadísticas (incluidas las comas) o por un máximo de 10 estadísticas. Habilitar un GET simple como este permite el almacenamiento en caché HTTP de las estadísticas solicitadas con frecuencia, lo que reduce el volumen de llamadas de los clientes que realizan muchas llamadas. |
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 el sistema de datos de jugador.
- 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.