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

Descarga varios archivos de varios usuarios con el mismo nombre de archivo. El archivo que se va a descargar viene determinado por el URI de la solicitud. El cuerpo de la solicitud contiene la lista de XUID de los usuarios cuyos archivos se van a descargar. El cuerpo de la respuesta será un mensaje MIME de varias partes, en el que cada parte representa un archivo de un usuario determinado con su propio conjunto de encabezados. Es posible que las partes de la respuesta sean una combinación de éxitos y errores.
El dominio de estos URI es `titlestorage.xboxlive.com`.

* [Parámetros de URI](#ID4EX)
* [Autorización](#ID4ECB)
* [Cuerpo de la solicitud](#ID4EPB)
* [Códigos de estado HTTP](#ID4E3C)
* [Encabezados de respuesta obligatorios](#ID4EPAAC)
* [Encabezados de respuesta opcionales](#ID4ESBAC)
* [Cuerpo de la respuesta](#ID4E3CAC)

## Parámetros de URI

| Parámetro | Tipo | Descripción |
| - | - | - |
| scid | guid | Id. de la configuración de servicio que se va a buscar. |
| pathAndFileName | string | Ruta de acceso y nombre de archivo del elemento al que se va a acceder. Los caracteres válidos para la parte de la ruta de acceso (hasta la última barra diagonal, incluida) incluyen letras mayúsculas (A-Z), letras minúsculas (a-z), números (0-9), guion bajo (*) y barra diagonal (/). La parte de la ruta de acceso puede estar vacía. Los caracteres válidos para la parte del nombre de archivo (todo lo que sigue a la última barra diagonal) incluyen letras mayúsculas (A-Z), letras minúsculas (a-z), números (0-9), guion bajo (*), punto (.) y guion (-). El nombre de archivo no puede estar vacío, terminar en un punto ni contener dos puntos consecutivos. |

## Autorización

La solicitud debe incluir un encabezado de autorización de XBOX LIVE válido. Si el autor de la llamada no tiene permiso para acceder a este recurso, el servicio devolverá una respuesta 403 Prohibido. Si el encabezado no es válido o falta, el servicio devolverá una respuesta 401 No autorizado.

## Cuerpo de la solicitud

\| Propiedad| Tipo| Descripción|
\| --- | --- | --- | --- | --- | --- |
\| xuids| matriz de enteros de 64 bits sin signo| Lista de XUID para los que se van a descargar archivos.|

### Ejemplo de solicitud

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

## Códigos de estado HTTP

El servicio devuelve uno de los códigos de estado de esta sección en respuesta a una solicitud realizada con este método en este recurso. Para obtener una lista completa de los códigos de estado HTTP estándar que se usan con los servicios de XBOX Live, consulte [Códigos de estado HTTP estándar](https://devdocs.xbox.com/es/reference/live/rest/additional/httpstatuscodes).

\| Código| Frase de motivo| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK | La solicitud se completó correctamente.|
\| 201| Created | Se creó la entidad.|
\| 400| Bad Request | El servicio no pudo entender una solicitud con formato incorrecto. Normalmente, un parámetro no válido.|
\| 401| Unauthorized | La solicitud requiere autenticación del usuario.|
\| 403| Forbidden | La solicitud no está permitida para el usuario o el servicio.|
\| 404| Not Found | No se encontró el recurso especificado.|
\| 406| Not Acceptable | No se admite la versión del recurso.|
\| 408| Request Timeout | La solicitud tardó demasiado en completarse.|
\| 500| Internal Server Error | El servidor encontró una condición inesperada que le impidió completar la solicitud.|
\| 503| Service Unavailable | La solicitud se ha limitado; reintente la solicitud después del valor de client-retry en segundos (por ejemplo, 5 segundos después).|

## Encabezados de respuesta obligatorios

\| Encabezado| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Disposition| Describe el contenido de la parte. Las partes "name" y "filename" del encabezado son el XUID del usuario al que pertenece este archivo.|
\| HttpStatusCode| Código de estado HTTP relacionado con la recuperación de este archivo en concreto.|

## Encabezados de respuesta opcionales

\| Encabezado| Descripción|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| ETag| Una ETag es un identificador opaco que un servidor web asigna a una versión específica de un recurso que se encuentra en una dirección URL. Si el contenido del recurso en esa dirección URL cambia en algún momento, se asigna una ETag nueva y diferente.|
\| Content-Type| Si el archivo se recuperó correctamente, este es el Content-Type del archivo.|
\| Content-Range| Si el archivo se recuperó correctamente y se trata de una descarga parcial, este es el intervalo de bytes del archivo contenido en la respuesta. |

## Cuerpo de la respuesta

Si la llamada se realiza correctamente, el servicio devolverá el contenido de los archivos solicitados en una respuesta de varias partes.

### Ejemplo de respuesta

```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

```

## Consulte también

##### Elemento primario

[/json/users/batch/scids/{scid}/data/{pathAndFileName},json](https://devdocs.xbox.com/es/reference/live/rest/uri/storage/uri-jsonusersbatchscidssciddatapathandfilenametype)


## Related topics

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