API:获取离线数据包下载地址
通过传入相应的ID获取对应离线数据包下载地址
文件转换ID:GET https://api.bimface.com/data/databag/downloadUrl?fileId={fileId}&type={type}&databagVersion={databagVersion}
集成模型ID:GET https://api.bimface.com/data/databag/downloadUrl?integrateId={integrateId}&type={type}&databagVersion={databagVersion}
模型对比ID:GET https://api.bimface.com/data/databag/downloadUrl?comapreId={compareId}&type={type}&databagVersion={databagVersion}
应用通过该接口获取离线包的下载地址,然后下载离线包,下载地址的有效时间是5分钟。
请求(Request)
Header
key | value | 示例 |
---|---|---|
Authorization | bearer {accessToken} | bearer xxxx-xxxx-xxxx-xxxx |
Content-Type | application/json | … |
Url Parameter
字段 | 类型 | 必填 | 描述 | 示例 |
---|---|---|---|---|
fileId | Number | Y | 通过文件转换ID获取离线数据包下载地址时必填 | 1199714943746080 |
integrateId | Number | Y | 通过集成模型ID获取离线数据包下载地址时必填 | 1299714943746080 |
compareId | Number | Y | 通过模型对比ID获取离线数据包下载地址时必填 | 1309714943746080 |
type | String | Y | 值必须是“offline” | offline |
databagVersion | String | N | 数据包版本,如果只有一个,则下载唯一的数据包,如果多个,则必须指定数据包版本 | 3.0 |
Request Body
无
curl -X POST
-H "Authorization: bearer <your accessToken>"
-H "Content-Type: application/json"
"https://api.bimface.com/data/databag/downloadUrl?fileId={your fileId}&type={type}&databagVersion={databagVersion}
https://api.bimface.com/data/databag/downloadUrl?integrateId={your integrateId}&type={type}&databagVersion={databagVersion}
https://api.bimface.com/data/databag/downloadUrl?comapreId={your compareId}&type={type}&databagVersion={databagVersion}"
响应(Response)
HTTP STATUS
200
成功返回
{
"code": "success",
"message": "",
"data": "http://bf-dev-databag.oss-cn-shanghai.aliyuncs.com/34cd5dc82d23615aef06b8eb1158b3e6/34cd5dc82d23615aef06b8eb1158b3e6.zip?Expires=1491791963&OSSAccessKeyId=QLYNXu7B9OTjErYR&Signature=a36eE3LuWNaqfSf4Aq2B/JXGqYw%3D"
}
失败返回
{
"code": "authentication.failed",
"message": "Token was not recognized."
}
错误码
code | 说明 |
---|---|
system.error | BIMFACE系统异常 |
authentication.failed | API访问合法性校验失败 |
offline.databag.not.found | 离线数据包未找到 |