文档首页/ 云空间服务 KooDrive/ API参考/ API/ 文件管理/ 获取下载链接 - getDownLoadUrl
更新时间：2025-10-22 GMT+08:00
查看PDF
分享

获取下载链接 - getDownLoadUrl

功能介绍

批量获取文件下载地址。

授权信息

当前API调用无需身份策略权限。

URI

POST /koodrive/ose/v1/files/download

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token}

X-User-Id

是

String

用户id，用于app鉴权

X-Date

是

String

日期，用于app鉴权

Host

是

String

地址，用于app鉴权

X-Traceid

否

String

消息日志跟踪标识（必须58位）

language

否

String

国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语
表2 请求Body参数

参数

是否必选

参数类型

描述

containerId

是

String

待获取文件所在的空间的标识

fileIds

是

Array of strings

文件id列表，最大支持传入100个文件id

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

code

Integer

返回码

msg

String

返回信息

batchCode

Integer

批量返回码，枚举值：

  • 0：部分成功

  • 1：全部成功

  • 2：全部失败

downloads

Array of DownloadInfoResponse objects

下载地址信息
表4 DownloadInfoResponse

参数

参数类型

描述

fileId

String

文件标识

fileName

String

文件名

url

String

下载地址

code

String

单条下载记录返回码

msg

String

单条下载记录返回信息

请求示例

获取文件的下载地址，可以通过该下载地址获取文件。

POST /koodrive/ose/v1/files/download

Authorization:Bearer+10f88*********4791e9ff

{
  "containerId": "IAADfsBFCO6WtAtuA9add2fea594e4e75b8feb8474ef236",
  "fileIds": [
    "Fn1bTLIOomJkTCAe9DEVBRY4U6IkuqkMZ"
  ]
}

响应示例

状态码：200

获取文件下载地址的响应消息

{
  "downloads" : [ {
    "fileId" : "Fn1bTLIOomJkTCAe9DEVBRY4U6IkuqkMZ",
    "url" : "https://b10-obs-ykj-uat-01.obs.cidc-rp-2006.joint.cmecloud.cn/5e3fc0c5d4fa45338f44db7177579c2c087?response-content-disposition=attachment%3B%20filename%3D%22%25E5%258F%2591%25E7%25A5%25A81.pdf%22&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20231227T072939Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=MKRISPBZAJWFHNBJ5WLB%2F20231227%2Fcidc-rp-2006%2Fs3%2Faws4_request&X-Amz-Signature=9d06798af17e2f1082b720f43af29a32b3154da4ddeee4f10025a758b599728a",
    "fileName" : "发票1.pdf",
    "code" : "0",
    "msg" : "success"
  } ],
  "batchCode" : 1,
  "code" : 0,
  "msg" : "Success."
}

状态码

状态码

描述

200

获取文件下载地址的响应消息
父主题： 文件管理

相关文档