Skip to main content

GET (/json/users/xuid()/scids//data/)

Enumera la información de archivos en una ruta de acceso especificada. El dominio de estos URI es titlestorage.xboxlive.com.

Parámetros de URI

Parámetros de cadena de consulta opcionales

| Parámetro| Tipo| Descripción| | --- | --- | --- | --- | --- | --- | | skipItems| int| Devuelve los elementos a partir de N+1 en la colección, es decir, omite N elementos.| | continuationToken| string| Devuelve los elementos a partir del token de continuación especificado. El parámetro continuationToken tiene prioridad sobre skipItems si se proporcionan ambos. En otras palabras, el parámetro skipItems se ignora si el parámetro continuationToken está presente.| | maxItems| int| Número máximo de elementos que se van a devolver de la colección, que se puede combinar con skipItems y continuationToken para devolver un intervalo de elementos. El servicio puede proporcionar un valor predeterminado si maxItems no está presente y puede devolver menos de maxItems, aunque aún no se haya devuelto la última página de resultados. |

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.

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 Authenticating and Authorizing XBOX LIVE Services Requests para obtener información adicional sobre cómo recuperar un token de STS y crear un encabezado de autorización.|

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

Cuerpo de la respuesta

Si la llamada se realiza correctamente, el servicio devolverá una matriz de objetos TitleBlob.

Ejemplo de respuesta

Consulte también

Elemento primario
/json/users/xuid()/scids//data/
Referencia TitleBlob (JSON)
PagingInfo (JSON)
Last modified on October 19, 2026