预签上传
请求方法
POST
请求地址
/im-files/upload/pre-sign
请求头域
| 参数 |
参数类型 |
数据类型 |
是否必需 |
描述 |
| Referer |
Header |
String |
是 |
值为URL格式，同预签上传的请求地址一致。 |
请求参数
| 参数 |
参数类型 |
数据类型 |
是否必需 |
描述 |
| fileType |
Body |
String |
是 |
文件类型及对应的限制要求 |
| fileName |
Body |
String |
是 |
文件名，与待上传的文件名一致 【长度最大限制：200；最小限制：1】 |
| fileSize |
Body |
Long |
是 |
文件大小文件的限制要求 |
| duration |
Body |
int |
否 |
文件的时长（视频、音频），单位:秒。不填充时无法显示具体时长。示例值：3文件的限制要求 |
备注
- 文件上传默认有效期为7天; 业务控制文件的有效期，类型如下：
- 发送单聊消息：默认单聊文件配置有效期7天
- 发送群聊消息：默认群聊文件配置有效期一年
HTTP状态码
| 返回值 |
描述 |
| 200 |
操作成功，详见响应参数 |
| 400 |
客户端传参异常 |
| 401 |
鉴权失败 |
| 500 |
服务端异常 |
响应参数
| 参数 |
数据类型 |
描述 |
| fileId |
String |
文件id |
| url |
String |
上传地址（使用Put方法上传至该地址） |
请求消息示例
POST /open/api/v2/im-files/upload/pre-sign HTTP/1.1
Host: api.yealink.com
Content-Type: application/json
{
"fileType": "chat_pic",
"fileName": "111.txt",
"fileSize": 1024
}
响应消息示例
{
"fileId": "asd4614asd1as5d41321asd561ads",
"url": "https://api.yealink.com/ydfs/dhjasdnkasdasd456asd4a61d4asd3a4sd15asd461a5s6d45as1d6"
}