数据上行接口

物联网平台通过数据上行接口将传感器设备上报的数据推送至客户系统,包含设备的采集数据上报,设备触发的事件上报,对设备的数据下行的结果上报

请求协议: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,否则物联网平台认为服务端接收失败

results matching ""

    No results matching ""