获取下载链接 - 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表示美式英语，不传默认美式英语
x-hw-share-folder-id	否	String	参数解释：共享文件夹ID。如果传入了该请求头，则说明当前的操作是在共享文件夹内。约束限制：不涉及取值范围：不涉及默认取值：不涉及

表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."
}