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 estleaderboards.xboxlive.com.
- Remarques
- Paramètres d’URI
- Paramètres de chaîne de requête
- Autorisation
- En-têtes de requête obligatoires
- En-têtes de requête facultatifs
- Corps de la requête
- Codes d’état HTTP
- En-têtes de réponse obligatoires
- En-têtes de réponse facultatifs
- Corps de la réponse
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
