> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # GET (/users/xuid({xuid})/scids/{scid}/stats) > GET (/users/xuid({xuid})/scids/{scid}/stats) # GET (/users/xuid({xuid})/scids/{scid}/stats) Obtient une configuration de service délimitée par une liste de noms de statistiques utilisateur séparés par des virgules, pour le compte de l'utilisateur spécifié. Le domaine de ces URI est `userstats.xboxlive.com`. * [Remarques](#ID4EV) * [Paramètres d'URI](#ID4EEB) * [Paramètres de chaîne de requête](#ID4EPB) * [Autorisation](#ID4EUC) * [En-têtes de requête obligatoires](#ID4EPD) * [En-têtes de requête facultatifs](#ID4EYE) * [Corps de la requête](#ID4E3F) * [Codes d'état HTTP](#ID4EHG) * [Corps de la réponse](#ID4E5BAC) ## Remarques Les clients ont besoin d'un moyen de lire et d'écrire des statistiques de titre pour le compte des joueurs dans notre nouveau système de statistiques des joueurs. ## Paramètres d'URI | Paramètre | Type | Description | | - | - | - | | xuid | GUID | XBOX User ID (XUID) de l'utilisateur pour le compte duquel accéder à la configuration de service. | | scid | GUID | Identificateur de la configuration de service qui contient la ressource à laquelle accéder. | ## 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 constitué de la liste de noms de statistiques utilisateur séparés par des virgules. Par exemple, l'URI suivant indique au service que quatre statistiques sont demandées pour le compte de l'ID utilisateur spécifié dans l'URI. `https://userstats.xboxlive.com/users/xuid({xuid})/scids/{scid}/stats/wins,kills,kdratio,headshots`Le nombre de statistiques pouvant être demandées en 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 des URI. Par exemple, la limite pourrait être fixée à 600 caractères de noms de statistiques (virgules comprises) ou à 10 statistiques au maximum. L'activation d'une simple requête GET comme celle-ci permet la mise en cache HTTP des statistiques fréquemment demandées, ce qui réduit le volume d'appels des clients bavards. | ## Autorisation 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 sandbox. L'autorisation des utilisateurs à accéder à un sandbox est gérée via Partner Center. Voici le pseudo-code de cette vérification : ```cpp theme={null} If (!checkAccess(serviceConfigId, resource, CLAIM[userid, deviceid, titleid])) { Reject request as Unauthorized } // else accept request. ``` ## En-têtes de requête obligatoires \| En-tête| Type| Description| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | \| Authorization| string| Informations d'identification pour l'authentification HTTP. Exemple de valeur : "XBL3.0 x=\;\".| ## En-têtes de requête facultatifs \| En-tête| Type| Description| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| X-RequestedServiceVersion| | Nom/numéro de build du service auquel cette requête doit être dirigée. La requête sera acheminée vers ce service uniquement après vérification de la validité de l'en-tête, des revendications du jeton d'authentification, etc. Valeur par défaut : 1.| ## Corps de la requête Aucun objet n'est envoyé dans le corps de cette requête. ## 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 XBOX Live Services, consultez [Codes d'état HTTP standard](/fr/reference/live/rest/additional/httpstatuscodes). \| Code| Phrase de motif| Description| \| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | \| 200| OK| La session a été récupérée avec succès.| \| 304| Not Modified| La ressource n'a pas été modifiée depuis la dernière requête.| \| 400| Bad Request| Le service n'a pas pu comprendre la requête mal formée. Généralement un paramètre non valide.| \| 401| Unauthorized| La requête nécessite l'authentification de l'utilisateur.| \| 403| Forbidden| La requête n'est pas autorisée pour l'utilisateur ou le service.| \| 404| Not Found| La ressource spécifiée est introuvable.| \| 406| Not Acceptable| La version de la ressource n'est pas prise en charge.| \| 408| Request Timeout| La version de la ressource n'est pas prise en charge ; doit être rejetée par la couche MVC.| ## Corps de la réponse ### Exemple de réponse ```cpp theme={null} { "user": { "xuid": "123456789", "gamertag": "WarriorSaint", "stats": [ { "statname": "Wins", "type": "Integer", "value": 40 }, { "statname": "Kills", "type": "Integer", "value": 700 }, { "statname": "KDRatio", "type": "Double", "value": 2.23 }, { "statname": "Headshots", "type": "Integer", "value": 173 } ], } } ``` ## Voir aussi ##### Parent [/users/xuid({xuid})/scids/{scid}/stats](/fr/reference/live/rest/uri/userstats/uri-usersxuidscidsscidstats) ## Related topics - [Event-based Leaderboards overview](/services/xbox-services/player-data/stats-leaderboards/event-based/live-leaderboards-eb-overview.md) - [Visão geral dos leaderboards baseados em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/live-leaderboards-eb-overview.md) - [XblUserStatisticsGetSingleUserStatisticAsync](/zh-TW/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md) - [XblUserStatisticsGetSingleUserStatisticsAsync](/zh-TW/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsasync.md)