>[info]性能數據推送
性能數據主要是指傳感器的實時業務數據,比如溫濕度傳感器的溫度、濕度數據;照明開關傳感器的開關狀態等都屬于性能數據,刷新頻率較高,為只讀數據,不支持反向控制;
接口地址:http://park.demo.neikongcn.com/api/hardware/sensor/pushPerformance
請求方式:POST
數據格式:JSON
字符編碼:UTF-8
輸入參數:
| 參數名稱 | 參數描述 | 數據類型 | 備注說明 |
| --- | --- | --- | --- |
| deviceId | 設備標識 | String | 每個設備的唯一標識 ,同一個設備的標識永久不變 |
| deviceType | 設備類型標識 | String | 每個設備類型的唯一標識 |
| pushDateTime | 推送時間 | String | 例如:2022-07-12 11:46:42 |
| items | 數據集合 | Array | 多條性能數據的集合 |
| items>>kpiKey | 指標標識 | String | 在同一類設備中不能重復,例如:WD表示溫濕度傳感器的溫度指標 |
| items>>kpiValue | 指標值 | String | 指標對應的值,例如:32.1 |
| items>>kpiSubfix | 指標單位 | String | 指標對應的值,例如:℃ |
輸入參數示例:
```
{
"deviceId":"00044d83-4eb9-48ce-b4ef-0d60bf89b68a", //設備唯一標識
"deviceType":"WSDCGQ", //設備類型標識,在所有設備中不能重復
"pushDateTime":"2022-07-12 11:46:42", //數據推送時間
"items":
[
{"kpiKey":"WD","kpiValue":"35.6","kpiSubfix":"℃"}, //指標名稱,指標值,指標單位
{"kpiKey":"PM25","kpiValue":"17","kpiSubfix":"um"}, //指標名稱,指標值,指標單位
]
}
```
輸出參數:
| 參數名稱 | 參數描述 | 數據類型 | 備注說明 |
| --- | --- | --- | --- |
| 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后。