Skip to main content

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

列出指定路径下的文件信息。 这些 URI 的域为 titlestorage.xboxlive.com。

URI 参数

可选的查询字符串参数

| 参数 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | | skipItems | int | 从集合中的第 N+1 项开始返回项目,例如,跳过 N 项。 | | continuationToken | string | 从给定的延续标记开始返回项目。如果同时提供了 continuationToken 和 skipItems 参数,则 continuationToken 参数优先。换言之,如果存在 continuationToken 参数,则忽略 skipItems 参数。 | | maxItems | int | 从集合中返回的最大项数,可与 skipItems 和 continuationToken 结合使用以返回一定范围的项目。如果没有提供 maxItems,服务可能会提供一个默认值,并且即使尚未返回最后一页结果,返回的项目数量也可能少于 maxItems。 |

授权

请求必须包含有效的 XBOX LIVE 授权标头。如果不允许调用方访问该资源,该服务将返回 403 Forbidden 响应。如果标头无效或缺失,该服务将返回 401 Unauthorized 响应。

必需的请求标头

| 标头 | 值 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version | 1 | API 协定版本。 | | Authorization | XBL3.0 x=[hash];[token] | STS 身份验证令牌。STSTokenString 替换为身份验证请求返回的令牌。有关检索 STS 令牌和创建授权标头的更多信息,请参见 Authenticating and Authorizing XBOX LIVE Services Requests。 |

请求正文

此请求的正文中不发送任何对象。

HTTP 状态代码

服务针对使用此方法对此资源发出的请求,返回本节中的某个状态代码。有关与 XBOX Live 服务一同使用的标准 HTTP 状态代码的完整列表,请参见 标准 HTTP 状态代码。 | 代码 | 原因短语 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200 | OK | 请求成功。 | | 201 | Created | 已创建实体。 | | 400 | Bad Request | 服务无法理解格式错误的请求。通常是无效参数。 | | 401 | Unauthorized | 请求需要用户身份验证。 | | 403 | Forbidden | 不允许该用户或服务发出请求。 | | 404 | Not Found | 找不到指定的资源。 | | 406 | Not Acceptable | 不支持资源版本。 | | 408 | Request Timeout | 请求完成时间过长。 | | 500 | Internal Server Error | 服务器遇到意外情况,无法完成请求。 | | 503 | Service Unavailable | 请求已被限流,请在客户端重试值(以秒为单位,例如 5 秒后)之后再次发送请求。 |

响应正文

如果调用成功,该服务将返回 TitleBlob 对象的数组。

响应示例

另请参阅

父主题
/trustedplatform/users/xuid()/scids//data/
参考资料 TitleBlob (JSON)
PagingInfo (JSON)
Last modified on October 19, 2026