mirror of
https://github.com/truewhile/MeBox.git
synced 2026-09-28 03:06:38 +08:00
truewhile
99 lines
3.1 KiB
Markdown
99 lines
3.1 KiB
Markdown
## 获取文件下载地址
|
|
|
|
### 基本信息
|
|
|
|
| 属性 | 内容 |
|
|
|:-----------|:--------------------------------|
|
|
| 接口名称 | 获取文件下载地址 |
|
|
| 接口版本 | 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 | 创建文档 |
|