Skip to main content

GET (/sessions//scids//data/)

列出指定路徑上的檔案資訊。 這些 URI 的網域為 titlestorage.xboxlive.com。

URI 參數

選擇性查詢字串參數

| 參數| 類型| 描述| | --- | --- | --- | --- | --- | --- | | skipItems| int| 從集合中的第 N+1 個項目開始傳回項目,例如,略過 N 個項目。| | continuationToken| 字串| 從指定的接續權杖開始傳回項目。如果同時提供 continuationToken 參數和 skipItems,則 continuationToken 參數優先。換句話說,如果有 continuationToken 參數,則會忽略 skipItems 參數。| | maxItems| int| 要從集合傳回的項目數目上限,可與 skipItems 和 continuationToken 結合以傳回某個範圍的項目。如果沒有 maxItems,服務可能會提供預設值,而且即使尚未傳回最後一頁結果,也可能傳回少於 maxItems 的項目。 |

授權

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

必要的要求標頭

| 標頭| 值| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| 1| API 合約版本。| | Authorization| XBL3.0 x=[hash];[token]| STS 驗證權杖。STSTokenString 會由驗證要求所傳回的權杖取代。如需擷取 STS 權杖及建立授權標頭的詳細資訊,請參閱「驗證和授權 XBOX LIVE 服務要求」。|

要求本文

此要求的本文中不會傳送任何物件。

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 秒後) 再次嘗試要求。|

回應本文

如果呼叫成功,服務將傳回 TitleBlob 物件的陣列。

範例回應

另請參閱

上層
/sessions//scids//data/
參考 TitleBlob (JSON)
PagingInfo (JSON)
Last modified on October 6, 2026