> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET (/json/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},json)

> GET (/json/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},json)

# GET (/json/users/xuid({xuid})/scids/{scid}/data/{pathAndFileName},json)

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

* [URI 参数](#ID4EX)
* [授权](#ID4ECB)
* [可选查询字符串参数](#ID4EPB)
* [必需的请求头](#ID4EQC)
* [可选请求头](#ID4EZD)
* [请求正文](#ID4EDF)
* [HTTP 状态代码](#ID4EQF)
* [响应头](#ID4EDDAC)
* [响应正文](#ID4EGEAC)

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| xuid | 无符号 64 位整数 | 发出请求的玩家的 XBOX 用户 ID (XUID)。 |
| scid | guid | 要查找的服务配置的 ID。 |
| pathAndFileName | string | 要访问项的路径和文件名。路径部分（直到并包括最终的正斜杠）的有效字符包括大写字母 (A-Z)、小写字母 (a-z)、数字 (0-9)、下划线 (*) 和正斜杠 (/)。路径部分可以为空。文件名部分（最终正斜杠之后的所有内容）的有效字符包括大写字母 (A-Z)、小写字母 (a-z)、数字 (0-9)、下划线 (*)、句点 (.) 和连字符 (-)。文件名不能为空、以句点结尾或包含两个连续的句点。 |

## 授权

请求必须包含有效的 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 状态代码](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/httpstatuscodes)。

\| 代码| 原因短语| 说明|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 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({xuid})/scids/{scid}/data/{pathAndFileName},json](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/storage/uri-jsonusersxuidscidssciddatapathandfilenametype)

##### 参考  [TitleBlob (JSON)](https://devdocs.xbox.com/zh-CN/reference/live/rest/json/json-titleblob)


## Related topics

- [XblTitleStorageDownloadBlobAsync](https://devdocs.xbox.com/es/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobasync.md)
- [XblTitleStorageGetBlobMetadataAsync](https://devdocs.xbox.com/ko/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragegetblobmetadataasync.md)