实体管理 API 总览
实体管理是大视景数字孪生服务 (DTS) 中的核心功能之一。通过这组 REST 接口，开发者可以在平台端动态定义产品模型（本体定义），并添加、修改、查询和删除具体关联的物理/虚拟设备实体。
功能说明
- 产品模型定义：支持创建产品本体、定义标准功能（属性、事件、服务）、导出和查询产品模型。
- 设备实例注册：在特定产品下，创建或删除单个/批量实体设备，生成接入所需的凭证。
- 实体状态检索：提供产品和实体层级的列表查询、详情检索、属性数值获取和更新维护。
接口列表与导航
您可以通过点击下方链接直接跳转到具体接口的详细描述页面：
| 接口名称 | 调用方法 | 接口路径 | 核心作用 |
|---|---|---|---|
| 🆕 创建产品 | POST |
/bv-microservice-digitaltwin-center/product/create |
注册产品本体模型，定义其数据格式与协议 |
| 📋 获取产品列表 | POST |
/bv-microservice-digitaltwin-center/product/findProductPage |
分页查询系统内已创建的产品本体 |
| 🔍 获取产品详情 | POST |
/bv-microservice-digitaltwin-center/product/findProductDetail |
获取特定产品的基本属性和网关配置信息 |
| ⚙️ 获取产品模型定义 | POST |
/bv-microservice-digitaltwin-center/product/findProductProfile |
查询产品标准的 JSON Profile (属性/事件/服务定义) |
| ➕ 添加实体 | POST |
/bv-microservice-digitaltwin-center/device/create |
在产品本体下注册并实例化设备实体，生成凭证 |
| 📂 获取实体列表 | POST |
/bv-microservice-digitaltwin-center/device/findDevicePage |
分页查询指定产品下的实体设备列表 |
| 👁️ 获取实体详情 | POST |
/bv-microservice-digitaltwin-center/device/findDeviceDetail |
获取特定实体的状态、配置和网关代理关系 |
| ✏️ 修改实体详情 | POST |
/bv-microservice-digitaltwin-center/device/update |
更新设备名称、状态、坐标等实例级配置 |
| 📈 获取实体属性信息 | POST |
/bv-microservice-digitaltwin-center/device/findDeviceProperties |
获取特定设备当前缓存的属性最新数据流 |
| ❌ 删除实体 | POST |
/bv-microservice-digitaltwin-center/device/delete |
从系统内移除指定的设备实体 |
作者：北京-产品-yantings 创建时间：2025-11-05 16:20
最后编辑：北京-产品-yantings 更新时间：2026-07-07 18:14
最后编辑：北京-产品-yantings 更新时间：2026-07-07 18:14
