获取下载链接
功能介绍
批量获取文件下载地址。
URI
POST /koodrive/ose/v1/files/download
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Authorization |
是 |
String |
该字段存储的是Access Token。调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。Access Token的获取请参考对应的开发手册,格式参考:Bearer+{access_token} |
X-Traceid |
否 |
String |
消息日志跟踪标识(必须58位) |
language |
否 |
String |
国际化语言标识,符合i18n规范,如zh-CN表示简体中文,en-US表示美式英语,不传默认美式英语 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
containerId |
是 |
String |
待获取文件所在的空间的标识 |
fileIds |
是 |
Array of strings |
文件id列表,最大支持传入100个文件id |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
code |
Integer |
返回码 |
msg |
String |
返回信息 |
batchCode |
Integer |
批量返回码,枚举值:
|
downloads |
Array of DownloadInfoResponse objects |
下载地址信息 |
请求示例
获取文件的下载地址,可以通过该下载地址获取文件。
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 |
获取文件下载地址的响应消息 |