> ## 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 (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)

> POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)

# POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},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](#ID4EX)
* [Autorisation](#ID4ECB)
* [Corps de la requête](#ID4EPB)
* [Codes d'état HTTP](#ID4E3C)
* [En-têtes de réponse obligatoires](#ID4EPAAC)
* [En-têtes de réponse facultatifs](#ID4ESBAC)
* [Corps de la réponse](#ID4E3CAC)

<a id="ID4EX" />

## Paramètres d'URI

| Paramètre | Type | Description |
| - | - | - |
| scid | guid | ID de la configuration de service à rechercher. |
| pathAndFileName | chaîne | Chemin d'accès et nom de fichier de l'élément auquel accéder. Les caractères valides pour la partie chemin (jusqu'à la dernière barre oblique incluse) sont les lettres majuscules (A-Z), les lettres minuscules (a-z), les chiffres (0-9), le trait de soulignement (*) et la barre oblique (/). La partie chemin peut être vide. Les caractères valides pour la partie nom de fichier (tout ce qui suit la dernière barre oblique) sont les lettres majuscules (A-Z), les lettres minuscules (a-z), les chiffres (0-9), le trait de soulignement (*), le point (.) et le trait d'union (-). Le nom de fichier ne peut pas être vide, se terminer par un point ni contenir deux points consécutifs. |

<a id="ID4ECB" />

## 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.

<a id="ID4EPB" />

## 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.|

<a id="ID4EQC" />

### Exemple de requête

```cpp theme={null}
{
    "xuids" : 
    [
      12345,
      45678,
      78901
    ]
}
      
```

<a id="ID4E3C" />

## 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](/fr/reference/live/rest/additional/httpstatuscodes).

\| 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).|

<a id="ID4EPAAC" />

## 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.|

<a id="ID4ESBAC" />

## 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. |

<a id="ID4E3CAC" />

## 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.

<a id="ID4EGDAC" />

### Exemple de réponse

```cpp theme={null}
HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: multipart/form-data; boundary=c0a9fd75-d036-4294-8b7b-85fea15a31bb

228
--c0a9fd75-d036-4294-8b7b-85fea15a31bb
Content-Disposition: binary; name="123"; filename="123"
HttpStatusCode: 200
ETag: 0x8CF327717411C31
Content-Type: application/octet-stream

asdf123
--c0a9fd75-d036-4294-8b7b-85fea15a31bb
Content-Disposition: binary; name="456"; filename="456"
HttpStatusCode: 200
ETag: 0x8CF32771E954BB8
Content-Type: application/octet-stream

asdf456
--c0a9fd75-d036-4294-8b7b-85fea15a31bb
Content-Disposition: binary; name="789"; filename="789"
HttpStatusCode: 404


--c0a9fd75-d036-4294-8b7b-85fea15a31bb--

0

```

<a id="ID4EUDAC" />

## Voir aussi

<a id="ID4EWDAC" />

##### Parent

[/json/users/batch/scids/{scid}/data/{pathAndFileName},json](/fr/reference/live/rest/uri/storage/uri-jsonusersbatchscidssciddatapathandfilenametype)


## Related topics

- [XblTitleStorageBlobMetadata](/reference/live/xsapi-c/title_storage_c/structs/xbltitlestorageblobmetadata.md)
- [XGameSaveFiles API overview](/build/core-features/common/game-save/xgamesavefiles.md)
- [XblTitleStorageDownloadBlobAsync](/es/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobasync.md)
