Téléchargement de fichiers à l'aide de l'API REST
Pour télécharger des fichiers, vous pouvez utiliser l'interface utilisateur de ThingWorx Composer ou l'API REST. L'utilisation de l'API REST permet de mieux contrôler la manière dont les fichiers sont téléchargés. Le lien de téléchargement direct vers un fichier est localhost/Thingworx/Things/SystemRepository/<fichier.txt>.
Vous pouvez également utiliser l'en-tête HTTP accept-ranges pour personnaliser le comportement de téléchargement.
Utilisation de l'en-tête HTTP accept-ranges
L'en-tête HTTP accept-ranges vous permet d'interrompre/de reprendre un téléchargement et de spécifier une plage d'octets à télécharger dans un fichier. Le format accepté est bytes=StartIndex-EndIndex.
• bytes=StartIndex-EndIndex : télécharge le contenu délimité par la plage d'octets spécifiée, y compris les index de début et de fin.
• bytes=StartIndex : télécharge le contenu du fichier depuis l'index de début spécifié jusqu'à fin du fichier, y compris les StartIndex et lastByteIndex.
• bytes=-endIndex : télécharge les derniers endIndexBytes. Par exemple, si bytes=-500, les 500 derniers octets seront téléchargés.
Remarques importantes concernant l'en-tête HTTP accept-ranges
• Si la valeur de l'endIndex est supérieure à la taille du fichier, l'endIndex est défini sur lastFileByteIndex.
• Si une plage d'octets n'est pas spécifiée, c'est l'intégralité du fichier qui est téléchargée.
• Les plages d'octets en plusieurs parties ne sont pas prises en charge.
Codes de statut HTTP pour l'en-tête HTTP accept-ranges
• 206 Partial Content : renvoyé lorsqu'une plage d'octets valide est téléchargée avec succès.
• 416 Range Not Satisfiable : renvoyé lorsque la plage spécifiée n'est pas valide ou qu'une exception est levée.