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) soit de tous les contacts connus de l’utilisateur actuel, soit uniquement des contacts désignés comme personnes favorites par cet utilisateur. 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 (via HTTPS). Elles reflètent des “pages” classées et triées de statistiques de joueur indexées, dérivées de statistiques utilisateur individuelles écrites via le système Player Data. Les index de classement complets peuvent être très 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 à un appelant de préciser le type de vue qu’il souhaite obtenir sur 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 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 implémentée pour les scénarios d’isolation 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 la 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, à condition que l’utilisateur soit autorisé à accéder au bac à sable. L’autorisation d’un utilisateur pour un bac à sable est gérée via Partner Center.

En-têtes de requête obligatoires

En-têtes de requête facultatifs

Corps de la requête

Pour que tout appelant puisse comprendre au mieux 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