统软云物联接口文档 - 消息推送

当设备状态发生变化时，平台将会把以下4类消息推送到您设置的服务器地址上：

4类消息推送到您设置的服务器地址上：

上/下线消息

指令执行消息

设备触发的事件消息

设备自主上报的状态消息

接口：消息推送 - 上/下线消息

触发条件

当设备登录、退出或断开连接时触发。
注：以test结尾的clientid为客户端测试帐号，此类客户端不会触发任何消息推送

---

注意：消息是实时推送的，如果推送失败，将再次尝试推送，直到推送成功，最多推送5次。
当返回状态HTTP 1.1 200 OK（只判断HTTP状态）时，就认为推送成功，所以没有返回值要求。

返回格式

上线

{
	"device": "1001",                                       //设备ID
	"oper": "connect",                                      //消息类型：上线
	"message": {                                            //消息主体
		"ip": "192.168.0.1",                                //ip地址
		"port": "49589",                                    //连接端口
		"client": "1001.1656070745",                        //clientid
		"user": "p2, c1, k60, u'esI7iRZtRe.ftyVWcgchf'",    //username
		"ts": "1656416279"                                  //时间戳，消息发送时间
	}
}

下线

{
	"device": "1001",                                       //设备ID
	"oper": "disconnect",                                   //消息类型：下线
	"message": {                                            //消息主体
		"client": "1001.1656070745",                        //clientid
		"reason": "normal",                                 //下线原因，可能的值normal：退出（设备退出）；timeout：超时（断网或断电，有10秒延迟）；closed：关闭（设备主动关闭连接）
		"ts": "1656416279"                                  //时间戳，消息发送时间
	}
}

接口：消息推送 - 指令执行消息

触发条件

当设备收到指令消息，并执行指令后，由设备回执消息给云端时触发。
注：以test结尾的clientid为客户端测试帐号，此类客户端不会触发任何消息推送

---

注意：消息是实时推送的，如果推送失败，将再次尝试推送，直到推送成功，最多推送5次。
当返回状态HTTP 1.1 200 OK（只判断HTTP状态）时，就认为推送成功，所以没有返回值要求。

返回格式

{
	"device": "1001",               //设备ID
	"oper": "order",                //消息类型：指令
	"message": {                    //消息主体
		"mid": "abc4e7c200bde2cc",  //消息ID，实为下发命令的消息ID
		"data": [                   //数组，为此次设备状态改变的内容，请参照设备所属产品的功能属性定义
			{
				"power": "1"
			}
		],
		"ts": "1656416279506"       //毫秒级时间戳，消息发送时间
	}
}

 接口：消息推送 - 设备触发的事件消息

触发条件

当用户操作设备（一般是通过设备操作面板/按钮），上报设备状态给云端时触发。
注：以test结尾的clientid为客户端测试帐号，此类客户端不会触发任何消息推送

---

注意：消息是实时推送的，如果推送失败，将再次尝试推送，直到推送成功，最多推送5次。
当返回状态HTTP 1.1 200 OK（只判断HTTP状态）时，就认为推送成功，所以没有返回值要求。

返回格式

{
	"device": "1001",               //设备ID
	"oper": "event",                //消息类型：事件
	"message": {                    //消息主体
		"mid": "abc4e7c200bde2cc",  //消息ID，16位字符串
		"data": [                   //数组，为此次设备状态改变的内容，请参照设备所属产品的功能属性定义
			{
				"power": "1"
			}
		],
		"ts": "1656416279506"       //毫秒级时间戳，消息发送时间
	}
}

 接口：消息推送 - 设备自主上报的状态消息

触发条件

设备（特别是传感器类设备）自主上报状态给云端时触发。
注：以test结尾的clientid为客户端测试帐号，此类客户端不会触发任何消息推送

---

注意：消息是实时推送的，如果推送失败，将再次尝试推送，直到推送成功，最多推送5次。
当返回状态HTTP 1.1 200 OK（只判断HTTP状态）时，就认为推送成功，所以没有返回值要求。

返回格式

{
	"device": "1001",               //设备ID
	"oper": "state",                //消息类型：状态
	"message": {                    //消息主体
		"mid": "abc4e7c200bde2cc",  //消息ID，16位字符串
		"data": [                   //数组，为此次设备状态改变的内容，请参照设备所属产品的功能属性定义
			{
				"power": "1"
			}
		],
		"ts": "1656416279506"       //毫秒级时间戳，消息发送时间
	}
}