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 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 (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
