获取文件下载信息

适用版本>=v7.0.2411a.20241114
接口说明：获取文件下载信息

请求说明

请求地址	配置域名+/openapi+`/v7/drives/{drive_id}/files/{file_id}/download`
请求方法	GET
签名方式	KSO-1（配置域名+/openapi不参与签名）
权限要求	查询和管理文件（应用授权） `kso.file.readwrite` 查询文件（应用授权） `kso.file.read` 查询和管理文件（用户授权） `kso.file.readwrite` 查询文件（用户授权） `kso.file.read`

Header	参数类型	是否必填	说明
X-Kso-Date	string	是	RFC1123 格式的日期，例: `Wed, 23 Jan 2013 06:43:08 GMT`
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》
Authorization	string	是	授权凭证，格式为：`Bearer {access_token}`

路径参数（Path）

名称	参数类型	是否必填	说明
drive_id	string	是	驱动盘id，<= 1024 characters
file_id	string	是	文件（夹）id，<= 1024 characters

查询参数（Query）

名称	参数类型	是否必填	说明
with_hash	bool	否	是否返回校验值
internal	bool	否	是否返回内部下载地址，默认为false

响应体（Response）

名称	类型	说明
data	object	获取文件下载信息信息返回
∟ url	string	文件下载链接
∟ hashes	object[]	哈希值
∟ ∟ sum	string	哈希结果
∟ ∟ type	string	哈希类型，固定为`s2s`
code	int	错误码
msg	string	状态信息
detail	string	详细信息

响应体示例

json

{
  "code": 0,
  "data": {
    "url": "http://encs-pri-minio/wpsfile/yundoc/HwJM1uTKTJIaQKhnN5r1jIUxmR2189140190625792?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=LTAIf5lqDRk6W4Mf%2F20230703%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20230703T084847Z&X-Amz-Expires=900&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3Bfilename%2A%3Dutf-8%27%27%25E5%25B7%25A5%25E4%25BD%259C%25E7%25B0%25BF.xlsx&X-Amz-Signature=4aa157324796242505d64850c33cc70bdc3ddbc12c8cc7b529bfced37b955666",
    "hashes": [
      {
        "type": "s2s",
        "sum": "NEaWrWiYV9Npn5jqnBNK3tEpyirtdD/UTAio+SYJcdQ="
      }
    ]
  },
  "detail": "",
  "msg": "ok"
}