平台联动
Studio 通过该通道读取 PlantPulse 平台的设备数据。在为应用选择使用哪些标签时,以及确认联动是否正常时使用。
联动状态
GET /api/platform/health
用于确认能否连接到平台、认证是否有效。当应用读不到数据时,这里是第一个要查看的地方。
数据浏览
GET /api/platform/browse?path={path}
按照站点 → 产线 → 设备 → 标签的顺序逐层向下浏览。path 需进行 URL 编码。为空值时表示最上层。
语义层
平台以本体(ontology)的形式管理设备结构。即使各现场的标签名称不同,也能通过语义进行查找,这就是该层的作用。
| 方法 | 路径 | 功能 |
|---|---|---|
GET | /api/semantic/ontology | 完整本体 |
GET | /api/semantic/ontology?site={siteId} | 单个站点的树结构 |
GET | /api/semantic/search?q={질의} | 基于语义的检索 |
检索支持以下选项。
| 选项 | 含义 |
|---|---|
site | 限定为特定站点 |
type | 限定结果类型(设备、标签等) |
limit | 结果数量 |
适用于不确定标签确切名称时——例如用“3号线压缩机排气温度”这样的说法——进行查找。