用途:面向 BIMFACE v3 服务端 RESTful API 的后端开发技能,适用于调用后端接口、开发后端服务、处理模型数据、上传下载文件、管理模型转换流程等场景。
主要能力:文件管理(文件上传/下载、版本管理、文件夹结构,含 Hub→项目→文件夹→文件项→版本文件五层管理);模型数据服务(构件属性查询、楼层/分类树、房间空间、碰撞检测,需文件先完成转换);模型转换派生服务(Translate 转换、Integrate 集成、Compare 对比,均为异步操作)。
使用方式:先通过 POST /oauth2/token 获取 Access Token(有效期 7 天),后续请求 Header 加 Authorization: Bearer {accessToken};异步操作建议传 callback 参数并验证 signature、返回 HTTP 200;通过 GET /view/token 获取 View Token(有效期 12 小时,每次使用自动续期)交给前端 JSSDK 加载模型;构件筛选使用 DSL 语法(match/contain/in/boolAnd/boolOr),targetType 可选 file 或 integration。编写代码前需读取 references/ 下对应 API 文档,并先做需求解析与范围确认。
限制与安全:appKey/appSecret 禁止硬编码或提交到 Git,须用环境变量或密钥管理服务注入;Access Token 不得透传给终端用户前端,须由开发者后端鉴权后代为调用;数值型参数如 fileId 在 JS 中可能超出安全整数范围,应以字符串传递;异步操作须确认状态为 success 后再进行下一步;需求无法匹配文档时应告知能力范围不支持。具体接口清单与完整参数以官方文档为准。