查询设备上的告警
例, 请求: http://api.shinemonitor.com/public/?sign=7f220b6f21d0b52d0452d9c66ffe1f4f84635b81&salt=2337424845041575962&token=91a6c87e89acbfb2fa482f3b02ee071ee58ea0293dd92f243a88ee51415f497f&action=queryDeviceWarning&device=COLLECTOR0001&devcode=512&devaddr=1&sn=687489900018&level=0&handle=true&i18n=zh_CN&page=0&pagesize=1&source=0&_app_client_=android&_app_id_=com.demo.test&_app_version_=3.6.2.1
| 参数 |
描述 |
必选 |
| action |
queryDeviceWarning |
是 |
| pn |
数采器编号 |
是 |
| devcode |
设备协议编码 |
是 |
| devaddr |
设备地址(485总线) |
是 |
| sn |
设备序列号 |
是 |
| level |
告警级别, 如果不传递此参数, 表示不关心 |
否 |
| handle |
是否已处理, true ? 已处理 : 未处理, 如果不传递此参数, 表示不关心 |
否 |
| sdate |
起始时间(设备时区), 格式: yyyy-mm-dd hh:mi:ss, 如果不传递此参数, 表示不关心 |
否 |
| edate |
截止时间(设备时区), 格式: yyyy-mm-dd hh:mi:ss, 如果不传递此参数, 表示不关心, sdate与edate必需同时存在, 查询时使用半开区间, 即 sdate <= date < edate |
否 |
| i18n |
国际化语言, 见多语言支持 |
是 |
| page |
分页处理, 第几页, 从0开始, 如果不传递此参数, 则被默认为0 |
否 |
| pagesize |
分页处理, 每页的记录数, 1 ~ 50, 如果不传递此参数, 则被默认为1 |
否 |
响应:
| 参数 |
描述 |
必选 |
| total |
告警总数 |
是 |
| page |
分页处理, 第几页 |
是 |
| pagesize |
分页处理, 每页的告警数 |
是 |
| warning[x].id |
告警唯一标识 |
是 |
| warning[x].uid |
电站业主id, 可能为0, 设备发生告警时还不属于任何电站业主 |
是 |
| warning[x].pid |
电站id, 可能为0, 设备发生告警时可能还没有被添加到任何电站 |
是 |
| warning[x].pn |
数采器编号 |
是 |
| warning[x].devcode |
设备协议编码 |
是 |
| warning[x].devaddr |
设备地址(485总线) |
是 |
| warning[x].sn |
设备序列号 |
是 |
| warning[x].alias |
设备别名 |
是 |
| warning[x].status |
是否为基于设备运行状态的告警 ? true : false |
是 |
| warning[x].level |
告警级别 |
是 |
| warning[x].code |
告警编码 |
否 |
| warning[x].desc |
告警描述 |
是 |
| warning[x].handle |
告警已处理 ? true : false |
是 |
| warning[x].gts |
告警产生时间, 格式为: yyyy-mm-dd hh:mi:ss, 设备时区 |
是 |
| warning[x].cts |
告警消失时间, 格式为: yyyy-mm-dd hh:mi:ss, 设备时区 |
否 |
{
"err":0,
"desc":"ERR_NONE",
"dat":{
"total":8,
"page":0,
"pagesize":1,
"warning":[
{
"id": "591afb417044a46e4c5ba050",
"uid":1,
"pid":1,
"pn":"COLLECTOR0000",
"devcode":512,
"devaddr":1,
"sn":"0123456789",
"status":false,
"level":0,
"code":"F0001",
"desc":"市电频率高",
"handle":true,
"gts":"2017-06-22 02:16:21"
}
]
}
}
可能出现的错误:
| 返回错误码 |
描述 |
详细描述 |
| 0x0006 |
ERR_FORMAT_ERROR |
参数错误 |
| 0x0007 |
ERR_MISSING_PARAMETER |
缺少必要的参数 |
| 0x0102 |
ERR_NOT_FOUND_DEVICE |
找不到设备 |
| 0x0108 |
ERR_NOT_FOUND_DEVICE_WARNING |
找不到设备告警 |