获取文件下载信息

适用版本>=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": "string",
    "hashes": [
      {
        "type": "s2s",
        "sum": "string"
      }
    ]
  },
  "detail": "",
  "msg": "ok"
}