获取文件下载地址
- 接口:common/files/v2/downloadUrl
- Method:POST
- 数据格式:JSON
- 限流信息:每小时1000次
- 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
- 接口说明:data中的json数据key为传入的文件名,value为对应的下载地址 具体参见
- 其他补充信息:本接口为批量接口,接口返回成功不代表全部处理成功。具体参见示例
参数:
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制 |
data |
String[] |
文件名数组 |
TRUE |
数组长度不超过100 |
返回参数
字段名称 |
字段类型 |
字段描述 |
resCode |
Integer |
响应状态码(见附录) |
resMsg |
String |
返回信息描述 |
data |
Array |
处理成功的结果数组 |
data[].fileName |
String |
文件名 |
data[].fileURL |
String |
文件下载地址,有效期2小时 |
示例:
请求数据
{
"data": [
"45460fcb-7045-48eb-be34-209dfad5f2ca.txt",
"9b175e6b-6918-4e52-8126-b7eed1483c7d.png"
]
}
返回数据
全部处理成功返回
{
"resCode": 200000,
"resMsg": "success",
"data": [{
"fileName": "45460fcb-7045-48eb-be34-209dfad5f2ca.txt",
"fileURL": "https://xxxxxx.cn-north-1.amazonaws.com.cn/45460fc"
},
{
"fileName": "9b175e6b-6918-4e52-8126-b7eed1483c7d.png",
"fileURL": "https://xxxxxxx.north-1.amazonaws.com.cn/9b175e6e"
}
]
}
部分处理成功返回
{
"resCode": 200000,
"resMsg": "success",
"data": [
{
"fileName": "45460fcb-7045-48eb-be34-209dfad5f2ca.txt",
"fileURL": "https://xxxxxx.cn-north-1.amazonaws.com.cn/45460fc"
}
]
}
全部处理失败返回
{
"resCode": 200000,
"resMsg": "success",
"data": []
}