Skip to main content

GET (/global/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 令牌和创建授权头的详细信息,请参阅 “对 XBOX LIVE 服务请求进行身份验证和授权”。|

请求正文

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

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 对象数组。

示例响应

另请参阅

上级
/global/scids//data/
参考 TitleBlob (JSON)
PagingInfo (JSON)
Last modified on October 19, 2026