Skip to main content

POST (/json/users/batch/scids//data/,json)

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

URI 參數

授權

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

要求本文

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

範例要求

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 | 要求已受到節流,請在 client-retry 值的秒數之後 (例如 5 秒後) 再次嘗試要求。|

必要的回應標頭

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

選用的回應標頭

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

回應本文

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

範例回應

另請參閱

上層
/json/users/batch/scids//data/,json
Last modified on October 6, 2026