# 健康管理使用手册
| ⽂档版本 | 内容修订 | 修订⼈ | 修订⽇期 |
|---|---|---|---|
| V1.0 | 初稿 | 郭程豪 | 2023-10-07 |
| V2.0 | 更新 | 郭程豪 | 2025-03-12 |
# 目录
# 一：上报设备状态
接口URL: POST http://127.0.0.1:1280/opshub/api/v1/health/device/status
Content-Type: application/json
认证方式: Bearer auth
- Body 请求参数
{
"time": 1693883441407, // 上报时间戳
"deviceId": "ae06f8e7-10fa-4131-be73-cec81c0a7045", // 设备id
"name": "拼接器1", // 设备名称
"model": "cysvc-cs", // 类型
"modelName": "cysvc-cs", // 类型名称
"type": "MCNet-5EP0-1J-4KH", // 型号
"typeName": "MCNet-5EP0-1J-4KH", // 型号名称
"nailHeight": 3, // 设备占用机柜钉子个数
"width": 0.5, // 设备宽（单位：米）
"height": 0.4, // 设备高（单位：米）
"deep": 0.3, // 设备深（单位：米）
"geoPoint": {
// 坐标
"lng": 11, // 经度
"lat": 22, // 纬度
"altitude": 33 // 海拔
},
"geoRotate": {
// 旋转角（左手坐标系）
"x": 44,
"y": 55,
"z": 66
},
"status": {
"status": "abnormal", // 设备整体状态 normal/warning/abnormal/unknown 正常/警告/异常/未知
"message": "设备出现1个端口故障", // 设备状态描述
"statusCode": 1002, // 状态码
"onlineTime": 0 // 在线时长
},
"layout": [
// 面板状态
{
"direction": "BACK", // 面板位置 UP/DOWN/LEFT/RIGHT/FRONT/BACK
"serialInterfaces": [
{
"type": "HDMI", // 串口类型
"index": 1, // 串口序号
"nodeIp": "", // 串口ip
"nodeType": "INPUT", // 输入输出类型 INPUT/OUTPUT
"bindPort": 1,
"expect": true, // 是否期望
"direction": "DOWN", // 串口方向
"usage": "",
"status": {
"status": "normal", // 串口状态
"message": "信号在线,光纤已连接",
"status_code": 1000, // 状态码
"online_time": 0 // 在线时长
}
}
]
}
],
......
}
- 响应示例 success
{
"data": "", //-
}
- 响应示例 fail
{
"code": 0, //返回码
"message": "" //错误信息
}