远程管理 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。