Dateien mithilfe der REST-API herunterladen
Sie können die ThingWorx Composer Benutzeroberfläche oder die REST-API verwenden, um Dateien herunterzuladen. Die Verwendung der REST-API bietet mehr Kontrolle darüber, wie Dateien heruntergeladen werden. Der direkte Download-Link zu einer Datei lautet localhost/Thingworx/Things/SystemRepository/<datei.txt>.
Sie können auch die HTTP-Kopfzeile accept-ranges verwenden, um das Download-Verhalten anzupassen.
HTTP-Accept-Ranges-Kopfzeile verwenden
Mit der HTTP-Kopfzeile accept-ranges können Sie einen Download unterbrechen oder wiederaufnehmen und einen Byte-Bereich angeben, der in eine Datei heruntergeladen werden soll. Das akzeptierte Format ist bytes=StartIndex-EndIndex.
• bytes=StartIndex-EndIndex – Lädt den Inhalt im angegebenen Byte-Bereich herunter, einschließlich Start- und Endindizes.
• bytes=StartIndex – Lädt den Inhalt vom angegebenen Startindex bis zum Ende der Datei herunter, einschließlich StartIndex und lastByteIndex der Datei.
• bytes=-endIndex – Lädt die letzten endIndexBytes herunter. Wenn beispielsweise bytes=-500 angegeben ist, werden die letzten 500 Byte heruntergeladen.
Wichtige Überlegungen zur HTTP-Accept-Ranges-Kopfzeile
• Wenn der endIndex-Wert größer als die Dateigröße ist, wird endIndex auf lastFileByteIndex festgelegt.
• Wenn der Byte-Bereich nicht angegeben ist, wird die gesamte Datei heruntergeladen.
• Mehrere Byte-Bereiche werden nicht unterstützt.
HTTP-Statuscodes für die HTTP-Accept-Ranges-Kopfzeile
• 206 Partial Content – Wird zurückgegeben, wenn ein gültiger Byte-Bereich erfolgreich heruntergeladen wurde.
• 416 Range Not Satisfiable – Wird zurückgegeben, wenn der angegebene Bereich ungültig ist oder eine Ausnahme auftritt.