# 生成分享链接
POST https://api.bimface.com/share
# 说明
文件发起转换、集成后,可以根据fileId或integrateId生成对应文件的分享链接;创建GIS场景后,也可通过GIS场景ID生成场景的分享链接。
# 参数
# Header
Authorization * | Bearer {accessToken} | string |
# Query
activeHours | 有效时长(与有效期限,二选一),单位:小时,如果不设置表示永久有效 | integer (int32) |
expireDate | 有效期限(与有效时长,二选一),单位:精确到天,如果不设置表示永久有效 | string |
fileId | 文件ID(与集成ID、场景ID 三选一) | integer (int64) |
integrateId | 集成模型ID(与文件ID、场景ID 三选一) | integer (int64) |
needPassword | 分享链接是否生成访问密码 | boolean |
sceneId | 场景ID(与文件ID、集成ID 三选一) | integer (int64) |
# 响应
HTTP代码 | 说明 | 类型 |
---|---|---|
200 | OK | GeneralResponse«ShareLinkBean» |
201 | Created | - |
401 | Unauthorized | - |
403 | Forbidden | - |
404 | Not Found | - |
# 200响应参数
GeneralResponse«ShareLinkBean»
名称 | 说明 | 类型 |
---|---|---|
code | 状态代码 | string |
data | 返回数据 | ShareLinkBean |
message | 提示消息 | string |
# 消耗
application/json
# 生成
*/*
application/json
# HTTP请求示例
# 请求 path
https://api.bimface.com/share?fileId=1938888813662976
# 请求 header
"Authorization: Bearer cn-e9725999-0b36-4c0e-bdca-38ea88888888"
# HTTP响应示例
# 响应 200
{
"code" : "success",
"data" : {
"createTime":"2020-11-29 00:00:00",
"expireTime" : "2020-11-30 00:00:00",
"expireTimestamp" : "1606665600000",
"password" : "abcde",
"projectId" : 10000000006016,
"url" : "https://api.bimface.com/preview/e41f2092"
},
"message" : null
}