>[danger]告警数据推送
告警数据推送主要用于推送传感器设备的告警数据,例如烟雾传感器的告警信息,电表的过载告警数据等。告警数据都有2中状态,即告警及告警消除;同时告警信息很具紧要程度划分为1到4四个级别,1为最高级别,4为最低级别。
接口地址:http://park.demo.neikongcn.com/api/hardware/sensor/pushAlarm
请求方式: POST
数据格式:JSON
字符编码:UTF-8
输入参数:
| 参数名称 | 参数描述 | 数据类型 | 备注说明 |
| --- | --- | --- | --- |
| deviceId | 设备标识 | String | 每个设备的唯一标识 ,同一个设备的标识永久不变 |
| deviceType | 设备类型标识 | String | 每个设备类型的唯一标识 |
| pushDateTime | 推送时间 | String | 例如:2022-07-12 11:46:42 |
| items | 数据集合 | Array | 多条性能数据的集合 |
| items>>alarmLevel | 告警级别 | Intger | 1到4,1为最高 |
| items>>alarmDesc | 告警描述 | String | 电压超过标准最高电压10% |
| items>>alarmDateTime | 告警时间 | String | 2022-07-12 11:59:59 |
| items>>alarmState | 告警状态 | String | "on"为告警,"off"为告警解除 |
输入参数示例:
```
{
"deviceId":"00044d83-4eb9-48ce-b4ef-0d60bf89b68a", //设备唯一标识
"deviceType":"WSDCGQ", //设备类型唯一标识
"pushDateTime":"2022-07-12 12:05:12", //数据推送时间
"items":
[
{
"alarmLevel":4, //告警级别,1-4四个级别 1最高
"alarmDesc":"电压超过标准最高电压10%", //告警信息描述
"alarmDateTime":"2022-07-12 11:59:59", //告警时间
"alarmState":"on" //告警状态 on-为告警 off-为告警解除
}
]
}
```
输出参数:
| 参数名称 | 参数描述 | 数据类型 | 备注说明 |
| --- | --- | --- | --- |
| code | 请求结果码 | Intger | 1表示成功,非1表示失败 |
| msg | 请求结果描述 | Intger | 成功时固定返回success,失败时返回具体的错误信息 |
| data | 请求响应数据 | mixed | 不同场景可能返回数组、字符串、整数或null |
请求成功时返回参数实例:
```
{
"code": 1,
"msg": "success",
"time": "1657597907",
"data": null
}
```
请求失败时返回参数实例:
```
{
"code": 0,
"msg": "数据签名错误",
"time": "1657597907",
"data": null
}
```
[注意]:
请求本接口需要加上数据验签的全部公共参数在请求URL后。