Skip to main content

​
POST (/json/users/batch/scids//data/,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

​
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

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

​
Consulte también

Elemento primario
/json/users/batch/scids//data/,json
Last modified on October 19, 2026