# 获取下载链接 - 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鉴权                                                                                                                                                                                                                                                                                                            |
| 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 | 下载地址信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   
 表4DownloadInfoResponse 
| 参数       | 参数类型   | 描述         |
|:---|:---|:---|
| 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 | 获取文件下载地址的响应消息 |