REST API を使用したファイルのダウンロード
ファイルをダウンロードするには、ThingWorx Composer ユーザーインタフェースまたは REST API を使用できます。REST API を使用すると、ファイルのダウンロード方法をより詳細に制御できます。ファイルへの直接ダウンロードリンクは localhost/Thingworx/Things/SystemRepository/<file.txt> です。
HTTP accept-ranges ヘッダーを使用して、ダウンロード動作をカスタマイズすることもできます。
HTTP accept-ranges ヘッダーの使用
HTTP accept-ranges ヘッダーを使用すると、ダウンロードを一時停止または再開したり、ダウンロードするバイトの範囲をファイルで指定したりできます。使用可能なフォーマットは bytes=StartIndex-EndIndex です。
• bytes=StartIndex-EndIndex - 指定したバイト範囲内のコンテンツを、開始インデックスと終了インデックスを含めてダウンロードします。
• bytes=StartIndex - 指定した開始インデックスからファイルの末尾までコンテンツを、ファイルの StartIndex と lastByteIndex を含めてダウンロードします。
• bytes=-endIndex - 最後の endIndexBytes をダウンロードします。たとえば、bytes=-500 の場合、最後の 500 バイトがダウンロードされます。
HTTP accept-ranges ヘッダーに関する重要な考慮事項
• endIndex 値がファイルサイズより大きい場合、endIndex は lastFileByteIndex に設定されます。
• バイト範囲を指定しない場合、ファイル全体がダウンロードされます。
• マルチパートバイト範囲はサポートされていません。
HTTP accept-ranges ヘッダーの HTTP ステータスコード
• 206 Partial Content - 有効なバイト範囲が正常にダウンロードされた場合に返されます。
• 416 Range Not Satisfiable - 指定した範囲が無効であるか、例外が発生した場合に返されます。