获取文件下载url

请求方法

GET

请求地址

/open/api/v1/calendar/files/download-url

请求header参数

参数名称	参数类型	是否必须	参数说明
referer	String	是	值为URL格式，可同请求地址一致。 请求响应结果返回的下载 URL 的 scheme://host.domain:port前缀，根据该 Referer 值的scheme://host.domain:port 而定。

请求query参数

参数名称	参数类型	是否必须	参数说明
fileId	String	是	文件id，即获取文件上传url接口返回的fileId

响应参数

参数名称	类型	参数说明
url	String	文件下载地址

请求消息示例

GET /open/api/v1/calendar/files/download-url?fileId=gk356661jt00u6doydk3zbp39tlsr 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

{
    "url": "http://simples.onyealink.com/allinone-10.200.112.137-uss/1e4c0da81def4d2091a92eb73d14b671?x-oss-signature=sqS%2Bts%2BO%2FlAS%2B1O33aIu%2F7tCzV5f1qizsIf72UlyUhk%3D&response-content-disposition=attachment%3Bfilename%2A%3Dutf-8%27%27123456.xlsx&versionId=CAEQHhiBgIDz0.zG2xciIDk0MmIwYjljNzZhMTQwMzk5Y2Q2MDJmZDlmMzMzN2Jm&x-oss-signature-version=OSS2&x-oss-expires=1629707581&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/download-url?fileId=gk356661jt00u6doydk3zbp39tlsr'

http状态码

返回值	描述
200	操作成功，详见响应参数
400	客户端传参异常
401	鉴权失败
500	服务端异常