1. 合并模型场景
合并多个模型的场景数据，便于前端同时加载多个模型。
请求方式：POST
请求地址：/api/{databaseKey}/scenes/merge
1.1. 请求参数
Headers：
| 参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
|---|---|---|---|---|
| Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | 操作的通关令牌 |
PathParas：
| 参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
|---|---|---|---|---|
| databaseKey | string | test | 是 | 数据库key，必传 |
SearchParas：
| 参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
|---|---|---|---|---|
| NULL | NULL | NULL | NULL | NULL |
Body
application/json:
{
"name": "合并场景",
"models": [
"M1259334486",
"M125934546"
],
"docKey": "012e245f581788970",
"treeStyle":"link" 或者 "merge"
}
1.2. 参数说明
| 参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
|---|---|---|---|---|
| name | string | 合并场景 | 否 | 名字 |
| models | 数组 | [ "M1259334486","M125934546"] | 否 | 模型key |
| docKey | string | 012e245f581788970 | 否 | docKey |
1.3. 正确返回
{
"message": "请求处理成功",
"code": "SUCCESS",
"data": {
"remark": "场景创建成功",
"key": "C1591753719211",
"status": "1"
}
}
1.4. 状态码
| 状态码 | code | message | data | 原因 |
|---|---|---|---|---|
| 400 | BAD_PARAMETER | "XXX", "data": null | NULL | 当请求参数错误时,具体错误消息有：子模型（xx）重复,子模型数量不能少于2个,子场景正在创建,子场景创建失败,子场景对象不存在 |
1.5. 备注
此接口DWG图纸不适用。
1.6. 注意事项
- 数据库启用gacl时，有模型关联的BOSF文档编辑权限的用户。
- 数据库未启用gacl时，有数据库访问权限的用户。
- 直接合并多个模型的场景数据，快速生成合并场景。
- name必须指定；
- models必须包含两个以上不同的模型，每个模型的场景已创建成功；
- docKey为场景对象对应的BOSF文档key
- treeStyle为合并模型树结构的样式，默认为merge： (1) link：树结构保留模型层级，第一层为原始模型名称 (2) merge：树结构不保留模型层级