> ## 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. # POST (/batch) > POST (/batch) # POST (/batch) Méthode POST qui fonctionne comme une méthode GET pour les requêtes de lot complexes portant sur plusieurs statistiques de joueurs dans plusieurs titres. Le domaine de ces URI est `userstats.xboxlive.com`. ## Remarques 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. * [Remarques](#ID4ET) * [Description](#ID4EFB) * [Autorisation](#ID4EUB) * [En-têtes de requête obligatoires](#ID4ETC) * [En-têtes de requête facultatifs](#ID4E3D) * [Corps de la requête](#ID4EAF) * [Codes d'état HTTP](#ID4EWF) * [Corps de la réponse](#ID4ENBAC) ## Description L'appelant fournit un corps de message contenant un tableau d'utilisateurs, des identifiants de configuration de service (SCID) et une liste de noms de statistiques par SCID pour lesquels récupérer ces statistiques. Il pourrait vous être utile d'examiner la méthode [GET](/fr-CA/reference/live/rest/uri/userstats/uri-usersxuidscidsscidstatsget) simple, à statistique unique, avant de lire cette page plus complexe en mode lot. ## 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 . * 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. L'exemple suivant est du pseudo-code pour la 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 ne sera acheminée vers ce service qu'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 ### Exemple de requête Le corps POST suivant informe le service que quatre statistiques sont demandées à partir de deux SCID différents pour deux utilisateurs différents. ```cpp theme={null} { "requestedusers": [ 1234567890123460, 1234567890123234 ], "requestedscids": [ { "scid": "c402ff50-3e76-11e2-a25f-0800200c1212", "requestedstats": [ "Test4FirefightKills", "Test4FirefightHeadshots" ] }, { "scid": "c402ff50-3e76-11e2-a25f-0800200c0343", "requestedstats": [ "OverallTestKills", "TestHeadshots" ] } ] } ``` ## 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](/fr-CA/reference/live/rest/additional/httpstatuscodes). \| Code| Expression de raison| 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. Il s'agit généralement d'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; devrait être rejetée par la couche MVC.| ## Corps de la réponse ### Exemple de réponse ```cpp theme={null} { "users":[ { "xuid": "123456789" "gamertag": "WarriorSaint", "scids":[ { "scid":"c402ff50-3e76-11e2-a25f-0800200c1212", "stats": [ { "statname":"Test4FirefightKills", "type":"Integer", "value":7 }, { "statname":"Test4FirefightHeadshots", "type":"Integer", "value":4 }] }, { "scid":"c402ff50-3e76-11e2-a25f-0800200c0343", "stats": [ { "statname":"OverallTestKills", "type":"Integer", "value":3434 }, { "statname":"TestHeadshots", "type":"Integer", "value":41 }] }], }, { "gamertag":"TigerShark", "xuid":1234567890123234 "scids":[ { "scid":"123456789", "stats": [ { "statname":"Test4FirefightKills", "type":"Integer", "value":63 }, { "statname":"Test4FirefightHeadshots", "type":"Integer", "value":12 }] }, { "scid":"987654321", "stats": [ { "statname":"OverallTestKills", "type":"Integer", "value":375 }, { "statname":"TestHeadshots", "type":"Integer", "value":34 }] }], }] } ``` ## Voir aussi ##### Parent [/batch](/fr-CA/reference/live/rest/uri/userstats/uri-batch) ## Related topics - [XblUserStatisticsGetMultipleUserStatisticsAsync](/ko/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsasync.md) - [XblUserStatisticsGetMultipleUserStatisticsForMultipleServiceConfigurationsAsync](/es/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetmultipleuserstatisticsformultipleserviceconfigurationsasync.md)