Saltar al contenido principal

GET (/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite})

Devuelve una tabla de clasificación social mediante la clasificación de los valores de estadística (puntuaciones) de todos los contactos conocidos del usuario actual o solo de los contactos que ese usuario ha designado como personas favoritas. El dominio de estos URI es leaderboards.xboxlive.com.

Comentarios

Las API de tablas de clasificación son todas de solo lectura y, por lo tanto, solo admiten el verbo GET (a través de HTTPS). Reflejan “páginas” clasificadas y ordenadas de estadísticas de jugador indexadas que se derivan de las estadísticas de usuario individuales que se escribieron a través del sistema de datos de jugador. Los índices completos de una tabla de clasificación pueden ser bastante grandes y los autores de llamadas nunca pedirán verlos en su totalidad; por lo tanto, este URI admite varios argumentos de cadena de consulta que permiten al autor de la llamada especificar qué tipo de vista quiere ver de esa tabla de clasificación. Las operaciones GET no modifican ningún recurso, por lo que producirán los mismos resultados si se ejecutan una o varias veces.

Parámetros de URI

Parámetros de cadena de consulta

Autorización

Se requiere autorización mediante xuid. 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.

Encabezados de solicitud obligatorios

Encabezados de solicitud opcionales

Cuerpo de la solicitud

Para maximizar la capacidad de cualquier autor de llamada de entender los datos que recibe y mostrarlos correctamente, cada valor de estadística de cada usuario se devolverá como una cadena en el formato en que debe mostrarse, con el formato correspondiente a la configuración regional especificada en el encabezado accept-language de la solicitud. También se devolverá un “nombre para mostrar” localizado para el statname de esa tabla de clasificación.

Miembros obligatorios

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.

Encabezados de respuesta obligatorios

Encabezados de respuesta opcionales

Cuerpo de la respuesta

Solicitud de tabla de clasificación social, sin paginación: https://leaderboards.xboxlive.com/users/xuid(2533274916402282)/scids/c1ba92a9-0000-0000-0000-000000000000/stats/EnemyDefeats/people/all?sort=descending

Ejemplo de respuesta

Consulte también

/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite}
Última modificación el 5 de noviembre de 2026