MeBox/115doc/115开放平台/API列表/文件管理/获取文件下载地址.md

获取文件下载地址

基本信息

属性	内容
接口名称	获取文件下载地址
接口版本	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

请求示例

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	文件违规时的申诉标识，按错误场景返回

响应示例

{
  "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	创建文档