API:获取文件下载地址
GET https://file.bimface.com/download/url
应用通过该接口获取文件的下载地址,然后下载文件。下载地址有效时间是5分钟。
请求(Request)
Header
key |
value |
示例 |
Authorization |
bearer {accessToken} |
bearer xxxx-xxxx-xxxx-xxxx |
Content-Type |
application/json |
… |
Url Parameter
字段 |
类型 |
必填 |
描述 |
示例 |
fileId |
Number |
Y |
文件Id |
924547689389024 |
name |
String |
N |
自定义文件下载名 |
… |
Request Body
无
curl -X GET
-H "Authorization: bearer <your accessToken>"
-H "Content-Type: application/json"
"https://file.bimface.com/download/url?fileId=<your fileId>&name=<your file name>"
响应(Response)
HTTP STATUS
200
成功返回
{
"code": "success",
"message": null,
"data": "http://bf-prod-srcfile.oss-cn-beijing.aliyuncs.com/0eee9736d0df47f3a25cbaf683df36ae?Expires=1478226327&OSSAccessKeyId=5nGlEwOIzrwCVaDZ&Signature=%2B4ciGb6FRdUCZIX7QEyvtuivtb0%3D&response-content-disposition=attachment%3B%20filename%3D%E7%BB%93%E6%96%BD%E7%BF%BB%E6%A8%A1-2017.rvt"
}
字段 |
类型 |
描述 |
示例 |
data |
String |
文件下载地址 |
… |
失败返回
{
"code": "authentication.failed",
"message": "Token was not recognized."
}
错误码
code |
说明 |
system.error |
BIMFace系统异常 |
authentication.failed |
API访问合法性校验失败 |
file.not.found |
文件不存在 |