## 获取文件下载地址

### 基本信息

| 属性         | 内容                              |
|:-----------|:--------------------------------|
| 接口名称       | 获取文件下载地址                        |
| 接口版本       | v1.0                            |
| 接口路径       | /downurl                        |
| 请求方法       | POST                            |
| 接口状态       | 生产环境                            |

### 接口说明

根据文件提取码获取文件下载地址。

### 接口地址

```
https://proapi.115.com/open/ufile/downurl
```

### 请求方式

```
POST
Content-Type: multipart/form-data
```

### 认证方式

```
Authorization: Bearer access_token
```

### 请求参数

| 参数名      | 类型     | 必填 | 默认值 | 说明    | 约束/示例            |
|:---------|:-------|:---|:----|:------|:-----------------|
| pick_code | string | 是  | -   | 文件提取码，多个提取码用半角逗号分隔 | dtctprlmfkl4exiok |

### 请求示例

```shell
curl 'https://proapi.115.com/open/ufile/downurl' \
  -H 'Authorization: Bearer access_token' \
  --form-string 'pick_code=dtctprlmfkl4exiok'
```

### 响应字段说明

| 字段                         | 类型      | 描述                         |
|:---------------------------|:--------|:---------------------------|
| state                      | boolean | 状态码，true 表示成功              |
| message                    | string  | 错误信息                       |
| code                       | int     | 错误码                        |
| errno                      | int     | 下载地址获取失败时返回的错误码             |
| data                       | object  | 响应数据                       |
| data.{文件ID}                | object  | 以文件ID为键的文件下载信息              |
| data.{文件ID}.file_name      | string  | 文件名                        |
| data.{文件ID}.file_size      | int     | 文件大小，单位为字节                  |
| data.{文件ID}.pick_code      | string  | 文件提取码                      |
| data.{文件ID}.sha1           | string  | 文件 SHA1 值                   |
| data.{文件ID}.url            | object  | 下载地址信息                     |
| data.{文件ID}.url.url        | string  | 文件下载地址                     |
| data.can_appeal            | boolean | 文件违规时是否可以申诉，按错误场景返回         |
| data.want_appeal_id        | string  | 文件违规时的申诉标识，按错误场景返回          |

### 响应示例

```json
{
  "state": true,
  "message": "",
  "code": 0,
  "data": {
    "2323423573680609857": {
      "file_name": "",
      "file_size": 0,
      "pick_code": "",
      "sha1": "",
      "url": {
        "url": ""
      }
    }
  }
}
```

### 注意事项

- `access_token` 由开放平台授权流程获取，并通过 `Authorization` 请求头传递。

### 修改历史

| 修改时间                         | 修改说明 |
|:-----------------------------|:-----|
| 2025年04月01日(周二) 00:00:00 | 创建文档 |