GET (/users/xuid()/scids//stats)
Obtient une configuration de service délimitée par une liste de noms de statistiques d’utilisateur séparés par des virgules, au nom de l’utilisateur spécifié. Le domaine de ces URI estuserstats.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
- Corps de la réponse
Remarques
Les clients ont besoin d’un moyen de lire et d’écrire des statistiques de titre au nom des joueurs dans notre nouveau système de statistiques de joueurs.Paramètres d’URI
Paramètres de chaîne de requête
| Paramètre| Type| Description| | --- | --- | --- | --- | --- | --- | | statNames| string| Le seul paramètre de chaîne de requête est le nom d’URI des noms de statistiques d’utilisateur séparés par des virgules. Par exemple, l’URI suivant informe le service que quatre statistiques sont demandées au nom de l’identifiant d’utilisateur spécifié dans l’URI.https://userstats.xboxlive.com/users/xuid({xuid})/scids/{scid}/stats/wins,kills,kdratio,headshotsLe nombre de statistiques pouvant être demandées dans un seul appel sera limité, et cette limite tiendra soigneusement compte d’un juste équilibre entre la commodité pour les développeurs et la longueur pratique de l’URI. Par exemple, la limite pourrait être déterminée par 600 caractères de texte de noms de statistiques (virgules comprises) ou par un maximum de 10 statistiques. Le fait de permettre un GET simple comme celui-ci active la mise en cache HTTP pour les statistiques fréquemment demandées, ce qui réduit le volume d’appels provenant des clients très bavards. |
Autorisation
Une logique d’autorisation est mise en œuvre pour les scénarios d’isolation du contenu et de contrôle d’accès.- Les classements et les statistiques d’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 dans 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 sandbox. L’autorisation des utilisateurs à accéder à un sandbox est gérée dans Partner Center.