​

GET (/sessions//scids//data/,)

Descarga un archivo. El dominio de estos URI es titlestorage.xboxlive.com.

• Parámetros de URI
• Autorización
• Parámetros de cadena de consulta opcionales
• Encabezados de solicitud obligatorios
• Encabezados de solicitud opcionales
• Cuerpo de la solicitud
• Códigos de estado HTTP
• Encabezados de respuesta
• Cuerpo de la respuesta

​

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 Forbidden. Si el encabezado no es válido o falta, el servicio devolverá una respuesta 401 Unauthorized.

​

Parámetros de cadena de consulta opcionales

Varía según el tipo de blob. Los blobs binarios no admiten parámetros de consulta. | Parámetro| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | | select| string| Solo se puede usar cuando el tipo es json. Especifica que la respuesta solo debe contener una determinada propiedad o valor del JSON, según lo determine este parámetro. Use un “punto” (.) para especificar subpropiedades y corchetes (’[’ y ’]’) para especificar índices de matriz. Por ejemplo, “array1[4].prop2” especifica la propiedad “prop2” del índice 4 de la matriz “array1”.|

​

Encabezados de solicitud obligatorios

| Encabezado| Valor| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| 1| Versión del contrato de la API.| | Authorization| XBL3.0 x=[hash];[token]| Token de autenticación de STS. STSTokenString se reemplaza por el token devuelto por la solicitud de autenticación. Consulte Autenticación y autorización de solicitudes de los servicios de XBOX LIVE para obtener más información sobre cómo recuperar un token de STS y crear un encabezado de autorización.|

​

Encabezados de solicitud opcionales

| Encabezado| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | If-Match| Especifica una ETag que debe coincidir con un elemento existente para completar la operación.| | If-None-Match| Especifica una ETag que no debe coincidir con ningún elemento existente para completar la operación.| | Range| Especifica el intervalo de bytes que se van a descargar. Sigue el formato estándar del encabezado Range de HTTP.|

​

Cuerpo de la solicitud

No se envía ningún objeto en el cuerpo de esta 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 realizó correctamente.| | 201| Created | Se creó la entidad.| | 400| Bad Request | El servicio no pudo interpretar 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 | La versión del recurso no es compatible.| | 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; vuelva a intentar la solicitud después del valor de client-retry en segundos (por ejemplo, 5 segundos después).|

​

Encabezados de respuesta

| Encabezado| Descripción| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | ETag| ETag es un identificador opaco asignado por un servidor web 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 alguna vez, se asigna una ETag nueva y diferente.| | Content-Range| Si se trató de una descarga parcial, este encabezado especifica el intervalo de bytes descargados.|

​

Cuerpo de la respuesta

Si la llamada se realiza correctamente, el servicio devolverá el contenido del archivo.

​

Consulte también

Elemento primario

/sessions//scids//data/,

Referencia TitleBlob (JSON)