订阅推送消息格式

各协议对应消息类型如下表:

接入协议 消息类型
TLINK 设备数据变化通知、设备指令响应通知、设备事件上报通知、设备上下线通知
MQTT 设备数据变化通知、设备指令响应通知、设备事件上报通知、设备上下线通知
LWM2M 设备数据变化通知、设备指令响应通知、设备事件上报通知、设备上下线通知
TUP 设备数据变化通知、设备指令响应通知、设备事件上报通知、设备上下线通知、设备TUP数据合并变化通知
HTTP/HTTPS 设备数据变化通知、设备事件上报通知、设备上下线通知
TCP 设备数据变化通知、设备指令响应通知、设备事件上报通知、设备上下线通知

消息格式描述:

(注:推送数据经过平台统一协议封装,对于本协议无意义的冗余字段或其他无用字段可予以忽略)

1、设备数据变化

参数名 说明 类型 必填
tenantId 租户ID string Y
productId 产品ID string Y
deviceId 设备ID string Y
messageType 消息类型=dataReport string Y
IMEI NB终端设备识别号 string N
IMSI NB终端sim卡标识 string N
deviceType 设备标识 string N
topic 数据上报主题 string Y
assocAssetId 合作伙伴ID string N
timestamp 时间戳 long Y
upPacketSN 上行报文序号 int N
upDataSN 数据上报报文序号 int N
serviceId 服务ID string N
protocol 协议类型 string Y
payload 消息负载,非透传消息格式为payload:消息内容JSON;透传消息格式为payload:{"APPdata":"消息内容BASE64编码"} json Y

样例:

{"deviceId":"2d1f1a708b5d4cef880937d67b5e5842","IMEI":"","IMSI":"","deviceType":"","tenantId":"1","productId":"1503","messageType":"dataReport","topic":"v1/up/ad","assocAssetId":"","timestamp":1528183784371,"payload":{"SignalPower":-792,"SNR":-55,"TxPower":50,"CellId":66966098,"Length":3,"Updata":"REVG"},"upPacketSN":-1,"upDataSN":-1,"serviceId":"","protocol":"tup"}

注:upPacketSN、upDataSN字段为Tlink协议特有字段,其他协议该字段为默认值-1。

2、设备命令响应

参数名 说明 类型 必填
tenantId 租户ID string Y
productId 产品ID string Y
deviceId 设备ID string Y
messageType 消息类型=commandResponse string Y
taskId 指令任务ID int/string Y
result 指令执行结果,其中:resultcode为指令执行状态(SUCCESSFUL:成功,SENT:已发送, DELIVERED:已送达, FAILED:失败);resultdetail为指令执行结果 json Y

样例:

{"tenantId":"1","productId":"1503","messageType":"commandResponse","deviceId":"2d1f1a708b5d4cef880937d67b5e5842","taskId":1,"result":{"resultCode": "SUCCESSFUL","resultDetail": {"Length": 2,"Rspdata": "Qkg="}}}

3、设备事件上报

参数名 说明 类型 必填
tenantId 租户ID string Y
productId 产品ID string Y
deviceId 设备ID string Y
messageType 消息类型=eventReport string Y
imei 终端设备识别号 string Y
imsi 终端sim卡标识 string Y
deviceSn 设备编号 string Y
timestamp 时间戳 long Y
eventType 事件类型,信息:1,警告:2,故障:3 int Y
eventContent 事件上报数据 json Y
serviceId 服务ID int Y
protocol 协议类型 string Y

样例:

{"tenantId":"1","productId":"10010208","deviceSn":"111qw","deviceId":"10010208111qw","messageType":"eventReport","imei":"xxx","imsi":"xx","timestamp":1554190965950,"eventType":1,"eventContent":{"m":44},"serviceId":1001,"protocol":"rdap"}

4、设备上下线

参数名 说明 类型 必填
tenantId 租户ID string Y
productId 产品ID string Y
deviceId 设备ID string Y
messageType 消息类型=deviceOnlineOfflineReport string Y
eventType 上线:1,下线:0 int Y
timestamp 时间戳 long Y

样例:

{"deviceId":"9df374dae2274942998bed25f6a451d6","tenantId":"1","productId":"10009151","eventType":1,"messageType":"deviceOnlineOfflineReport","timestamp":1554198201870}

5、TUP合并数据变化

参数名 说明 类型 必填
tenantId 租户ID string Y
productId 产品ID string Y
deviceId 设备ID string Y
messageType 消息类型=dataReportTupUnion string Y
IMEI NB终端设备识别号 string N
IMSI NB终端sim卡标识 string N
deviceType 设备标识 string N
topic 数据上报主题 string Y
assocAssetId 合作伙伴ID string N
timestamp 时间戳 int Y
upPacketSN 上行报文序号 int N
upDataSN 数据上报报文序号 int N
serviceId 服务ID string N
protocol 协议类型 string Y
payload 消息负载 json Y

样例:

{"deviceId":"143b4d4cc64e4c16981000159d27c7c6","IMEI":"","IMSI":"xx","deviceType":"","tenantId":"1","productId":"10002052","messageType":"dataReportTupUnion","topic":"v1/up/ads","assocAssetId":"","timestamp":1554198622509,"payload":{"services":[{"serviceId":"Datas","serviceType":"Datas","data":{"datas":"0002000F383633373033303337303831383230000800130DFF2E074805D801E30700000402113213454E000F000116"},"eventTime":"20190402T095022Z"}]},"upPacketSN":-1,"upDataSN":-1"serviceId":"","protocol":"tup"}

注:upPacketSN、upDataSN字段为Tlink协议特有字段,此类型消息该字段均为默认值-1。

搜索结果 ""

    没有搜索结果 ""