Passer au contenu principal

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

Retourne un classement social en classant les valeurs de statistiques (scores) de tous les contacts connus de l’utilisateur actuel ou uniquement des contacts que cet utilisateur a désignés comme personnes favorites. Le domaine de ces URI est leaderboards.xboxlive.com.

Remarques

Les API de classement sont toutes en lecture seule et ne prennent donc en charge que le verbe GET (sur HTTPS). Elles reflètent des « pages » classées et triées de statistiques de joueurs indexées, dérivées des statistiques individuelles des utilisateurs écrites au moyen du système Player Data. Les index de classement complets peuvent être assez volumineux, et les appelants ne demanderont jamais à en voir un dans son intégralité; cet URI prend donc en charge plusieurs arguments de chaîne de requête qui permettent à l’appelant de préciser le type de vue qu’il souhaite obtenir de ce classement. Les opérations GET ne modifient aucune ressource; elles produisent donc les mêmes résultats, qu’elles soient exécutées une seule fois ou plusieurs fois.

Paramètres d’URI

Paramètres de chaîne de requête

Autorisation

Une autorisation par XUID est requise. Une logique d’autorisation est mise en œuvre pour les scénarios d’isolement du contenu et de contrôle d’accès. Les classements et les statistiques utilisateur peuvent être lus à partir de clients sur n’importe quelle plateforme, à condition que l’appelant soumette un jeton XSTS valide avec sa requête. Les écritures sont évidemment limitées aux clients pris en charge par le système Player Data. Les développeurs de titres peuvent marquer les statistiques comme ouvertes ou restreintes avec Partner Center. Les classements sont des statistiques ouvertes. Les statistiques ouvertes sont accessibles par Smartglass, ainsi que par les applications iOS, Android, Windows, Windows Phone et Web, tant que l’utilisateur est autorisé dans le sandbox. L’autorisation des utilisateurs dans un sandbox est gérée au moyen de Partner Center.

En-têtes de requête obligatoires

En-têtes de requête facultatifs

Corps de la requête

Pour permettre à tout appelant de bien comprendre les données qu’il reçoit afin de les afficher correctement, chaque valeur de statistique de chaque utilisateur est retournée sous forme de chaîne dans le format dans lequel elle doit être affichée, et mise en forme selon les paramètres régionaux spécifiés dans l’en-tête accept-language de la requête. Un « nom d’affichage » localisé est également retourné pour le statname de ce classement.

Membres obligatoires

Codes d’état HTTP

Le service retourne l’un des codes d’état de cette section en réponse à une requête effectuée avec cette méthode sur cette ressource. Pour obtenir la liste complète des codes d’état HTTP standard utilisés avec les services XBOX Live, consultez Codes d’état HTTP standard.

En-têtes de réponse obligatoires

En-têtes de réponse facultatifs

Corps de la réponse

Requête de classement social, sans pagination : https://leaderboards.xboxlive.com/users/xuid(2533274916402282)/scids/c1ba92a9-0000-0000-0000-000000000000/stats/EnemyDefeats/people/all?sort=descending

Exemple de réponse

Voir aussi

/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite}
Dernière modification le 5 novembre 2026