透過 REST API 使用檔案存放庫
除了使用 Composer UI 下載檔案以外,您也可以使用 REST API,它可讓您在下載時使用更多選項。檔案的直接連結是 localhost/Thingworx/Things/SystemRepository/<file.txt>,但您也可以使用 HTTP 接受範圍標頭來取得更多選項。
|
ThingWorx 8.5.9 及更新版本提供此功能。
|
使用 HTTP 接受範圍標頭
HTTP 接受範圍標頭可用於暫停及繼續下載。您也可以指定要下載的位元組範圍,您可以開始與暫停下載,或稍後繼續。接受的格式為 bytes=StartIndex-EndIndex。
• bytes=StartIndex-EndIndex - 下載指定範圍的內容,Start 與 EndIndex 包括在內。
• bytes=StartIndex - 下載指定範圍的內容,檔案的 StartIndex 與 lastByteIndex。
• bytes=-endIndex - 下載最後的 endIndexBytes。例如,如果 bytes=-500,將會下載最後 500 個位元組。
• 如果 endIndex 大於檔案大小,會將 endIndex 設定為 lastFileByteIndex。
• 如果未傳遞位元組範圍,將會下載整個檔案。
• 不允許使用多部份的位元組範圍。
• 如果您在 HTTP 請求的標題中傳遞 "Range",且檔案已成功下載,回應中會傳回狀況代碼 206。
• 如果您在 HTTP 請求的標頭中傳遞「範圍」,且發生任何例外,將會在回應中傳回狀況代碼 416。