Download di file mediante l'API REST
Per scaricare i file, è possibile utilizzare l'interfaccia utente di ThingWorx Composer o l'API REST. L'utilizzo dell'API REST offre maggiore controllo sulla modalità di download dei file. Il link diretto per il download a un file è localhost/Thingworx/Things/SystemRepository/<file.txt>.
È inoltre possibile utilizzare l'intestazione HTTP accept-ranges per personalizzare il comportamento di download.
Utilizzo dell'intestazione HTTP Accept-Ranges
L'intestazione HTTP accept-ranges consente di sospendere o riprendere un download e specificare un intervallo di byte da scaricare in un file. Il formato accettato è bytes=StartIndex-EndIndex.
• bytes=StartIndex-EndIndex - Scarica il contenuto nell'intervallo di byte specificato, inclusi gli indici iniziale e finale.
• bytes=StartIndex - Scarica il contenuto dall'indice iniziale specificato fino alla fine del file, inclusi i parametri StartIndex e lastByteIndex del file.
• bytes=-endIndex - Scarica l'ultimo parametro endIndexBytes. Ad esempio, se bytes=-500, vengono scaricati gli ultimi 500 byte.
Considerazioni importanti per l'intestazione HTTP accept-ranges
• Se il valore di endIndex è maggiore della dimensione del file, endIndex viene impostato su lastFileByteIndex.
• Se l'intervallo di byte non viene specificato, viene scaricato l'intero file.
• Gli intervalli di byte multiparte non sono supportati.
Codici di stato HTTP per l'intestazione HTTP accept-ranges
• 206 Partial Content - Restituito quando viene scaricato un intervallo di byte valido.
• 416 Range Not Satisfiable - Restituito quando l'intervallo specificato non è valido o si verifica un'eccezione.