​

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

下載檔案。 這些 URI 的網域為 titlestorage.xboxlive.com。

• URI 參數
• 授權
• 選擇性查詢字串參數
• 必要的要求標頭
• 選擇性要求標頭
• 要求本文
• HTTP 狀態碼
• 回應標頭
• 回應本文

​

URI 參數

​

授權

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

​

選擇性查詢字串參數

依 Blob 類型而有所不同。二進位 Blob 不支援查詢參數。 | 參數| 類型| 描述| | --- | --- | --- | --- | --- | --- | | select| 字串| 僅在類型為 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 | 要求已受到節流，請在 client-retry 值的秒數之後 (例如 5 秒後) 再次嘗試要求。|

​

回應標頭

| 標頭| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | ETag| ETag 是網頁伺服器指派給 URL 上特定版本資源的不透明識別碼。如果該 URL 上的資源內容有所變更，就會指派新的不同 ETag。| | Content-Range| 如果這是部分下載，此標頭會指定已下載的位元組範圍。|

​

回應本文

如果呼叫成功，服務將傳回檔案的內容。

​

另請參閱

上層

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

參考 TitleBlob (JSON)