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