跳到主要内容

远程管理 API

当管理客户端需要被动读取 DarraRT 状态或提交受控维护命令时,使用 RemoteAccess HTTPS。它属于 服务 / 远程通道:现场 Service 监听固定端口 18443。

这是产品自带的两条远程通道之一(另一条是 DarraLink TCP 18821)。不要建议 RDP、SSH、Telnet 或 VNC,也不要把本页当成 MES 接口——真 MES 走 OPC UA。

本页不是工程里的 HTTP REST 8080 数据服务。

服务约定​

名称类别读写当前值说明
协议连接只读HTTPS不提供明文 HTTP 回退
端口连接只读18443固定,界面不可改
认证安全读写API Key + JWT使用现场管理员凭据
速率限制安全只读每来源 100 req/s超限返回 429

端点​

名称类别读写方法路径
运行状态诊断只读GET/api/status
读变量过程数据只读GET/api/variables/{address}
写变量过程数据写(事务)POST/api/variables/{address}
写入回执过程数据只读GET/api/variable-writes/{transactionId}
活动报警诊断只读GET/api/alarms
确认报警诊断写POST/api/alarms/{id}/ack
系统诊断诊断只读GET/api/diagnostics
PLC 周期诊断诊断只读GET/api/plc/diagnostics
子网扫描发现只读GET/api/scan
启动 PLC控制写POST/api/plc/start
停止 PLC控制写POST/api/plc/stop
上传项目工程写POST/api/project/upload
下载项目工程只读POST/api/project/download
最近日志诊断只读GET/api/logs
结束会话安全写POST/api/auth/logout

变量写入​

变量写入不是同步“写完即成功”。服务接受后返回 202 和 transactionId,客户端必须查询回执直到终态。网络超时后只查询原事务,不要重复提交同一写命令。

POST /api/variables/DB1.SetPoint
Content-Type: application/json

{"value": 42}

使用边界​

  • 适合管理界面读状态、报警和诊断,不代替 EtherCAT 或 PLC 扫描。
  • 启停和变量写入受运行状态、权限与安全条件约束,服务可能拒绝。
  • 客户端应处理 400、401、403、404、409、429 和 503。
  • 不要自行改端口、关闭认证或改用明文 HTTP。

第三方标准变量访问见 OPC UA。入口选择见 外部程序接入。