Web API
本机 HTTP 接口。完整字段与诊断用法见独立侧栏：
真正用法是西门子式诊断：先看运行态、通道诊断、报警和过程数据质量，再按需读写过程数据。
| 项 | 值 |
|---|---|
| 品牌 | Darra Profinet Slave |
| 监听 | 仅本机回环；端口固定、不可配置（数字见 GET /api/info 的 port） |
| JSON | camelCase；枚举为字符串 |
| 鉴权 | 回环默认放行。配置了 Api:ApiKey 后必须带 X-Darra-PnS-Api-Key |
| 请求体上限 | 64 KB（超限 HTTP 413） |
| 授权 | 无授权端点。未授权时 POST /api/start 失败 |
失败统一 { "success": false, "message", "code", "errorCode", "timestamp" }。内部异常不进响应。
GET / 返回基础观测页。JSON 服务信息在 GET /api/info。
端点
| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /api/info | 服务信息 + 端点清单 |
| GET | /api/status | 运行态快照 |
| GET | /api/diag | 诊断计数器 / AR / 事件簿 |
| POST | /api/diag | 标准通道诊断 add / update / remove |
| GET | /api/alarms | 活动报警 |
| GET | /api/alarms/history | 报警历史（最近 500 条） |
| POST | /api/alarms/ack | 确认单条活动报警 |
| POST | /api/alarms/ack-all | 确认全部活动报警 |
| POST | /api/alarm | 发送过程报警 |
| GET | /api/io | 过程映像 |
| POST | /api/io | 写设备→控制器区 |
| GET | /api/im | I&M |
| GET | /api/records | 用户区记录 |
| POST | /api/start | 启动 |
| POST | /api/stop | 软停 |
| POST | /api/reset | 复位 |
| POST | /api/config/reload | 重载配置（下次启动生效） |
周期数据交换进行中调用 stop / reset / config/reload 会打断应用关系。先等 connected=false。