> ## 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.

# POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)

> POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)

# POST (/json/users/batch/scids/{scid}/data/{pathAndFileName},json)

從多個使用者下載具有相同檔案名稱的多個檔案。要下載的檔案由要求的 URI 決定。要求本文包含要下載其檔案之使用者的 XUID 清單。回應本文將是多部分 MIME 訊息，每個部分代表特定使用者的一個檔案，並具有自己的一組標頭。回應的各個部分可能混合了成功和失敗的結果。
這些 URI 的網域為 `titlestorage.xboxlive.com`。

* [URI 參數](#ID4EX)
* [授權](#ID4ECB)
* [要求本文](#ID4EPB)
* [HTTP 狀態碼](#ID4E3C)
* [必要的回應標頭](#ID4EPAAC)
* [選用的回應標頭](#ID4ESBAC)
* [回應本文](#ID4E3CAC)

<a id="ID4EX" />

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| scid | guid | 要查閱之服務設定的識別碼。 |
| pathAndFileName | string | 要存取之項目的路徑和檔案名稱。路徑部分 (直到並包含最後一個正斜線) 的有效字元包括大寫字母 (A-Z)、小寫字母 (a-z)、數字 (0-9)、底線 (*) 及正斜線 (/)。路徑部分可以是空的。檔案名稱部分 (最後一個正斜線之後的所有內容) 的有效字元包括大寫字母 (A-Z)、小寫字母 (a-z)、數字 (0-9)、底線 (*)、句點 (.) 及連字號 (-)。檔案名稱不可為空的、不可以句點結尾，也不可包含兩個連續的句點。 |

<a id="ID4ECB" />

## 授權

要求必須包含有效的 XBOX LIVE 授權標頭。如果不允許呼叫者存取此資源，服務將傳回 403 Forbidden 回應。如果標頭無效或遺漏，服務將傳回 401 Unauthorized 回應。

<a id="ID4EPB" />

## 要求本文

\| 屬性| 類型| 描述|
\| --- | --- | --- | --- | --- | --- |
\| xuids| 64 位元不帶正負號整數的陣列| 要為其下載檔案的 XUID 清單。|

<a id="ID4EQC" />

### 範例要求

```cpp theme={null}
{
    "xuids" : 
    [
      12345,
      45678,
      78901
    ]
}
      
```

<a id="ID4E3C" />

## HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼，以回應在此資源上使用此方法所提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單，請參閱[標準 HTTP 狀態碼](/zh-TW/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 | 要求已受到節流，請在 client-retry 值的秒數之後 (例如 5 秒後) 再次嘗試要求。|

<a id="ID4EPAAC" />

## 必要的回應標頭

\| 標頭| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Disposition| 描述該部分的內容。標頭的 "name" 和 "filename" 部分是此檔案所屬使用者的 XUID。|
\| HttpStatusCode| 與擷取此特定檔案相關的 HTTP 狀態碼。|

<a id="ID4ESBAC" />

## 選用的回應標頭

\| 標頭| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| ETag| ETag 是 Web 伺服器指派給位於某個 URL 之資源特定版本的不透明識別碼。如果該 URL 的資源內容有所變更，就會指派新的不同 ETag。|
\| Content-Type| 如果已成功擷取檔案，這是檔案的 Content-Type。|
\| Content-Range| 如果已成功擷取檔案且為部分下載，這是回應中所包含之檔案的位元組範圍。 |

<a id="ID4E3CAC" />

## 回應本文

如果呼叫成功，服務將在多部分回應中傳回所要求檔案的內容。

<a id="ID4EGDAC" />

### 範例回應

```cpp theme={null}
HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: multipart/form-data; boundary=c0a9fd75-d036-4294-8b7b-85fea15a31bb

228
--c0a9fd75-d036-4294-8b7b-85fea15a31bb
Content-Disposition: binary; name="123"; filename="123"
HttpStatusCode: 200
ETag: 0x8CF327717411C31
Content-Type: application/octet-stream

asdf123
--c0a9fd75-d036-4294-8b7b-85fea15a31bb
Content-Disposition: binary; name="456"; filename="456"
HttpStatusCode: 200
ETag: 0x8CF32771E954BB8
Content-Type: application/octet-stream

asdf456
--c0a9fd75-d036-4294-8b7b-85fea15a31bb
Content-Disposition: binary; name="789"; filename="789"
HttpStatusCode: 404


--c0a9fd75-d036-4294-8b7b-85fea15a31bb--

0

```

<a id="ID4EUDAC" />

## 另請參閱

<a id="ID4EWDAC" />

##### 上層

[/json/users/batch/scids/{scid}/data/{pathAndFileName},json](/zh-TW/reference/live/rest/uri/storage/uri-jsonusersbatchscidssciddatapathandfilenametype)


## Related topics

- [XblTitleStorageBlobMetadata](/reference/live/xsapi-c/title_storage_c/structs/xbltitlestorageblobmetadata.md)
- [XGameSaveFiles API overview](/build/core-features/common/game-save/xgamesavefiles.md)
- [XblTitleStorageDownloadBlobAsync](/reference/live/xsapi-c/title_storage_c/functions/xbltitlestoragedownloadblobasync.md)