获取文件上传url
请求方法
GET
请求地址
/open/api/v1/calendar/files/upload-url
请求header参数
| 参数名称 |
参数类型 |
是否必须 |
参数说明 |
| referer |
String |
是 |
值为URL格式，可同请求地址一致。
请求响应结果返回的上传 URL 的 scheme://host.domain:port前缀，根据该 Referer 值的scheme://host.domain:port 而定。 |
请求query参数
| 参数名称 |
参数类型 |
是否必须 |
参数说明 |
| fileName |
String |
是 |
文件名 |
| type |
String |
是 |
文件类型，详见fileType文件类型 |
| fileSize |
Long |
是 |
文件大小，单位字节 |
响应参数
| 参数名称 |
类型 |
参数说明 |
| fileId |
String |
文件id |
| url |
String |
上传文件的url
（使用Put方法上传文件至该地址） |
请求消息示例
GET /open/api/v1/calendar/files/upload-url?fileName=test&type=eventAttachment&fileSize=1024 HTTP/1.1
Host: smart.yealink.com
Content-Type: application/json
Referer: https://smart.yealink.com:443
成功响应示例
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
"fileId": "923aa8f31b6c46998dada2eb95ccdcce",
"url": "http://cloud-netdisk-cn-shenzhen-simples.oss-cn-shenzhen.aliyuncs.com/allinone-10.200.112.137-uss/296ff9b8b0dd44899d3c59a3a64d2361.jpg?x-oss-signature=WttLNUGExlYzNbOz3vfeD%2F0pECEQefajP9oVVxaosCA%3D&x-oss-signature-version=OSS2&x-oss-expires=1631081868&x-oss-access-key-id=LTAI4GG825ZhKZhjdKwtGe7f"
}
CURL命令实例
curl -XGET -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJwc3QiOjAsImFyZWEiOiJDTi1CSiIsImNvdW50cnkiOiJDTiIsImN0IjoxLCJzIjoxMDAsImV4IjoxNTgzNzQ5OTQ3ODg2LCJ0IjoibyIsImNpIjoiMDgyOWI4Mjg3NjI3NDg2NDg5YzEwN2ViYzI0NGVmNjMiLCJwaWQiOiJhZThjZDNkNjNlYjU0OWM0YWNmMWJiOTdlOGEwMTkyMiIsImp0aSI6IjI1NmE5OTc5MWJkMDRlNDJhYWZhYzcyOWNkMzkxZDZjIn0.hDQCgrBTAZgYo8cKjfq5dZIc4C_Np0HTxwKuvmAu05awC-vdmopDQ67PXBJRDFihTLAhNBE-9oTF5_PmWhmERTrFaXPDp8bA9vetHP1JVuZK36J88EGgNE3thBoObLEGRyJASxP0BAe-tkXE-AXdRA08Bzolo27AIWVEAADb6Vk' -H 'Content-Type: application/json' -H 'timestamp: 1583742732181' -H 'nonce: 53f0765fadb54fb6b002f3baac2d5ec8' 'https://smart.yealink.com/open/api/v1/calendar/files/upload-url?fileName=test&type=eventAttachment&fileSize=1024'
http状态码
| 返回值 |
描述 |
| 200 |
操作成功，详见响应参数 |
| 400 |
客户端传参异常 |
| 401 |
鉴权失败 |
| 500 |
服务端异常 |
FileType文件类型
| 类型值 |
说明 |
| eventAttachment |
日程附件 |