​

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

下载文件。 这些 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 令牌和创建授权头的详细信息，请参阅 “对 XBOX LIVE 服务请求进行身份验证和授权”。|

​

可选请求头

| 头| 说明| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 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| 如果这是部分下载，则此头指定下载的字节范围。|

​

响应正文

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

​

另请参阅

上级

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

参考 TitleBlob (JSON)