​

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

下载文件。 这些 URI 的域为 titlestorage.xboxlive.com。

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

​

URI 参数

​

授权

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

​

可选的查询字符串参数

因 blob 类型而异。二进制 blob 不支持查询参数。 | 参数 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | | select | string | 仅在 type 为 json 时可用。指定响应仅应包含 JSON 的某个属性/值,由该参数确定。使用 “点”(.) 指定子属性,使用方括号(“[” 和 “]”)指定数组索引。例如,“array1[4].prop2” 指定 “array1” 数组的索引 4 的 “prop2” 属性。 |

​

必需的请求标头

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

​

可选的请求标头

| 标头 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | If-Match | 指定必须与现有项匹配的 ETag,以完成操作。 | | If-None-Match | 指定不得与任何现有项匹配的 ETag,以完成操作。 | | Range | 指定要下载的字节范围。遵循标准 HTTP Range 标头格式。 |

​

请求正文

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

​

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 秒后)之后再次发送请求。 |

​

响应标头

| 标头 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | ETag | ETag 是 Web 服务器分配给 URL 处特定资源版本的不透明标识符。如果该 URL 处的资源内容发生更改,则会分配新的不同的 ETag。 | | Content-Range | 如果这是部分下载,此标头指定已下载的字节范围。 |

​

响应正文

如果调用成功,该服务将返回文件的内容。

​

另请参阅

父主题

/sessions//scids//data/,

参考资料 TitleBlob (JSON)