Skip to main content

​
POST (/json/users/batch/scids//data/,json)

Télécharge plusieurs fichiers portant le même nom de fichier provenant de plusieurs utilisateurs. Le fichier à télécharger est déterminé par l’URI de la requête. Le corps de la requête contient la liste des XUID des utilisateurs dont les fichiers doivent être téléchargés. Le corps de la réponse est un message MIME en plusieurs parties, chaque partie représentant un fichier pour un utilisateur particulier avec son propre ensemble d’en-têtes. Les parties de la réponse peuvent comporter à la fois des réussites et des échecs. Le domaine de ces URI est titlestorage.xboxlive.com.

​
Paramètres d’URI

​
Autorisation

La requête doit inclure un en-tête d’autorisation XBOX LIVE valide. Si l’appelant n’est pas autorisé à accéder à cette ressource, le service renvoie une réponse 403 Forbidden. Si l’en-tête est non valide ou manquant, le service renvoie une réponse 401 Unauthorized.

​
Corps de la requête

| Propriété| Type| Description| | --- | --- | --- | --- | --- | --- | | xuids| tableau d’entiers 64 bits non signés| Liste des XUID pour lesquels télécharger les fichiers.|

​
Exemple de requête

​
Codes d’état HTTP

Le service renvoie 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. | Code| Expression de raison| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK | La requête a réussi.| | 201| Created | L’entité a été créée.| | 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 une 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 requête a pris trop de temps.| | 500| Internal Server Error | Le serveur a rencontré une condition inattendue qui l’a empêché de traiter la requête.| | 503| Service Unavailable | La requête a été limitée. Réessayez après la valeur client-retry en secondes (par exemple, 5 secondes plus tard).|

​
En-têtes de réponse obligatoires

| En-tête| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Disposition| Décrit le contenu de la partie. Les parties “name” et “filename” de l’en-tête correspondent au XUID de l’utilisateur auquel appartient ce fichier.| | HttpStatusCode| Code d’état HTTP lié à la récupération de ce fichier particulier.|

​
En-têtes de réponse facultatifs

| En-tête| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | ETag| L’ETag est un identificateur opaque attribué par un serveur web à une version spécifique d’une ressource trouvée à une URL. Si le contenu de la ressource à cette URL change, un nouvel ETag différent est attribué.| | Content-Type| Si le fichier a été récupéré avec succès, il s’agit du Content-Type du fichier.| | Content-Range| Si le fichier a été récupéré avec succès et qu’il s’agit d’un téléchargement partiel, il s’agit de la plage d’octets du fichier contenue dans la réponse. |

​
Corps de la réponse

Si l’appel réussit, le service renvoie le contenu des fichiers demandés dans une réponse en plusieurs parties.

​
Exemple de réponse

​
Voir aussi

Parent
/json/users/batch/scids//data/,json
Last modified on October 6, 2026

Related topics

XblTitleStorageBlobMetadataXGameSaveFiles API overviewXblTitleStorageDownloadBlobAsync