>[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后。