《Synology File Station Official API》第四章-File Station API_Download

SYNO.FileStation.Download 

说明 

下载文件/文件夹。 

概述 

可用性：自 DSM 6.0 

版本：2 

方法 

  download 

描述： 

下载文件/文件夹。如果只指定一个文件，则响应文件内容。如果给出了多个文件/文件夹，则会响应压缩到的 ZIP 格式的二进制内容。 

可用性： 

从版本 2 

请求： 

参数	描述	值	默认  值	可用性
路径	一个或多个文件/文件夹路径，以要下载的共享文件夹开头，用逗号分隔，括号括起来。当要下载多个文件时，文件/文件夹将被压缩为 zip 文件。	String	(None)	2 及以后
mode	用于下载文件/文件夹的模式，值可以是：  "open"：尝试触发应用程序，例如网络浏览器打开它。响应的 HTTP 头的 Content-Type 根据文件扩展名设置为 MIME 类型。  “download”：尝试触发应用程序，例如网络浏览器，下载它。响应的 HTTP 标头的 Content Type 设置为 application/octet-stream，并且  的 HTTP 标头的 Content Disposition  设置为附件。	open 或  download	open	2 及更高版本

示例： 

GET /webapi/entry.cgi?api=SYNO.FileStation.Download&version=2&method=download& 
path=%5B%22%2Ftest%2FITEMA_20445972-0.mp3%22%5D&mode=%22open%22

响应：

文件内容。 

 

API 错误代码 

没有特定的 API 错误代码。 

注意：如果 mode 参数设置为 open 值，发生错误时响应 HTTP 头的状态码“404 Not Found”。