数据上行接口
物联网平台通过数据上行接口将传感器设备上报的数据推送至客户系统,包含设备的采集数据上报,设备触发的事件上报,对设备的数据下行的结果上报
请求协议:HTTP
请求类型:POST
请求地址:客户提供接收地址,在“数据推送配置”中进行配置 请求数据格式:JSON形式
| 参数名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| device_id | string | 是 | 设备ID |
| device_unit | string | 是 | 设备型号 |
| device_category | string | 是 | 设备类型 |
| version | string | 否 | 标识接口协议的版本,缺省认为是1.0版本 |
| type | int | 否 | 数据类型。不存在或0:数据;1:事件;2:响应 |
| data | object | 否 | 当type不存在或为0时必须存在,内容为解析后的数据对象,具体内容依赖各型号的设备数据格式 |
| event | object | 否 | 当type为1时必须存在,内容为设备触发的事件内容,具体内容依赖各型号的设备数据格式 |
| response | object | 否 | 当type为2时必须存在,内容为数据下发的结果响应 |
data内容为经过解析后的对象,当type不存在或为0时必须存在,根据不通的设备属性,数据内容也不尽相同。例如温湿度类型数据内容为:
| 参数名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| temp | float | 否 | 温度 |
| humidity | float | 否 | 湿度 |
| collect_time | date | 是 | 数据采集时间 |
| storage_time | date | 是 | 数据存储时间 |
event内容为设备属性发生变化,触发预定的规则,当type为1时必须存在,例如:
| 参数名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| event_id | string | 是 | 事件ID |
| data | object | 是 | 触发告警的数据报文,同上述data |
response为数据下发的异步响应,当type为2时必须存在:
| 参数名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| request_id | string | 是 | 下行请求ID |
| code | int | 是 | 错误状态码,0成功,非0失败 |
| msg | string | 否 | 错误描述,当code非0时必须存在 |
服务端成功接收到HTTP POST请求后,需返回状态码200,否则物联网平台认为服务端接收失败