组织结构 API 总览
在数字孪生世界中，设备实体通常不孤立存在，而是以层级、空间或业务结构组织在一起。组织结构 API 用于创建和管理这些业务层级关系（即孪生体树结构）。
核心概念：孪生体 (Twin)
- 孪生体可以是物理区域（如：大楼 ➡️ 楼层 ➡️ 房间）、也可以是逻辑组织（如：集团 ➡️ 分公司 ➡️ 车间）。
- 通过将具体的设备实体关联到指定的孪生体节点下，为孪生看板、低代码设计器及数据流分析提供空间感知的层级数据上下文。
接口列表与导航
您可以点击下方超链接跳转到对应的接口开发说明：
| 接口名称 | 调用方法 | 接口路径 | 核心作用 |
|---|---|---|---|
| 📁 创建孪生体 | POST |
/bv-microservice-digitaltwin-center/twin/create |
动态创建一个层级组织节点（孪生体） |
| 🔗 添加实体到孪生体 | POST |
/bv-microservice-digitaltwin-center/twin/addEntity |
将一个或多个实体设备关联绑定到指定的孪生体节点 |
| 🗑️ 删除孪生体 | POST |
/bv-microservice-digitaltwin-center/twin/delete |
移除整个孪生体层级节点 |
| 📴 删除孪生体下实体 | POST |
/bv-microservice-digitaltwin-center/twin/removeEntity |
解除具体设备实体与孪生体层级节点的绑定关系 |
| 🌳 获取孪生体结构以及管理的实体 | POST |
/bv-microservice-digitaltwin-center/twin/findTwinStructure |
查询并构建整棵孪生体组织树，获取各节点关联的设备 |
作者：北京-产品-yantings 创建时间：2025-11-26 17:56
最后编辑：北京-产品-yantings 更新时间：2026-07-07 18:14
最后编辑：北京-产品-yantings 更新时间：2026-07-07 18:14
