GET (/sessions/{sessionId}/scids/{scid}/data/{path})

项目
05/10/2023

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

URI 参数
可选查询字符串参数
授权
必需请求标头
请求正文
HTTP 状态代码
响应正文

URI 参数

参数	类型	说明
sessionId	字符串	要查找的会话的 ID。
scid	guid	要查找的服务配置的 ID。
路径	字符串	要返回的数据项的路径。返回所有匹配的目录和子目录。有效字符包括大写字母 (A-Z)、小写字母 (a-z)、数字 (0-9)、下划线 (_) 和正斜杠 (/)。可以为空。最大长度为 256 个字符。

可选查询字符串参数

参数	类型	说明
skipItems	int	返回集合中以 N+1 开头的项目（例如跳过 N 个项目）。
continuationToken	字符串	返回从给定延续令牌开始的项目。如果同时提供，continuationToken 参数优先于 skipItems。换言之，如果 continuationToken 参数出现，skipItems 参数将被忽略。
maxItems	int	要从集合返回的项目的最大数量，这可与 skipItems 和 continuationToken 结合使用来返回一系列项目。如果 maxItems 不存在，服务可能会提供默认值，并可能返回少于 maxItems 个的项目，即使尚未返回最后一页结果也是如此。

授权

请求必须包含有效的 Xbox LIVE 授权标头。如果调用方无权访问此资源，该服务将返回“403 已禁止”响应。如果标头无效或缺失，该服务将返回“401 未授权”响应。

必需请求标头

标头	值	说明
x-xbl-contract-version	1	API 协定版本。
授权	XBL3.0 x=[hash];[token]	STS 身份验证令牌。 STSTokenString 被身份验证请求返回的令牌替换。有关检索 STS 令牌和创建授权标头的其他信息，请参阅“对 Xbox LIVE 服务请求进行身份验证和授权”。

请求正文

对象不会在此请求的正文中发送。

HTTP 状态代码

服务返回此部分中的状态代码之一，以响应使用此方法对此资源发出的请求。对于用于 Xbox Live 服务的标准 HTTP 状态代码的完整列表，请参阅标准 HTTP 状态代码。

代码	原因短语	说明
200	OK	请求已成功。
201	Created	实体已创建。
400	无效请求	服务无法理解格式错误的请求。通常是无效参数。
401	未授权	请求需要用户身份验证。
403	已禁止	用户或服务不允许此请求。
404	未找到	找不到指定资源。
406	不可接受	不支持资源版本。
408	请求超时	请求完成时间太长。
500	内部服务器错误	服务器遇到了阻止它执行请求的意外情况。
503	服务不可用	请求受到限制，请在客户端重试秒数值（例如，5 秒以后）后再次尝试请求。

响应正文

如果调用成功，该服务将返回一系列 TitleBlob 对象。

示例响应

{
"blobs":
[
    {
        "fileName":"foo\bar\blob.txt,binary",
        "clientFileTime":"2012-01-01T01:02:03.1234567Z",
        "displayName":"Friendly Name",
        "size":12,
        "etag":"0x8CEB3E4F8F3A5BF"
    },
    {
        "fileName":"foo\bar\blob2.txt,binary",
        "displayName":"Blob 2",
        "size":4,
        "etag":"0x8CEB3FE57F1A142"
    },
    {
        "fileName":"foo\jsonblob.txt,json",
        "size":15,
        "etag":"0x8CEB40152B4A6F8"
    }
],
"pagingInfo":
    {
        "continuationToken":"54",
    }
}

通过