和目开放平台开发文档

消息订阅

消息订阅流程

  1. 在开放平台web端配置消息回调地址。
  2. 开放平台把消息以发送HTTP POST请求的方式发送到回调地址。

消息统一数据结构：

参数名称 参数类型 参数含义 说明
appId String 应用id
sig String 签名 MD5(appId+secret),计算值为32位小写
msgList list 消息列表

msgList数据格式：

参数名称 参数类型 参数含义 说明
msgType String 消息类型
timeStamp String 消息时间戳 13位毫秒
data String 消息内容 
{
	"appId": "xxx",
	"sig": "xxx",
	"msgList": [{
		"msgType": "xxx",
		"timeStamp": "xxx",
		"data": {
			"xxx": "xxx"
		}
	}, {
		"msgType": "xxx",
		"timeStamp": "xxx",
		"data": {
			"xxx": "xxx"
		}
	}]
}

消息类型

消息类型 说明
MESSAGE_DEVICE_BIND 设备绑定消息
MESSAGE_DEVICE_UNBIND 设备解绑消息
MESSAGE_DEVICE_ONLINE 设备上线消息
MESSAGE_DEVICE_OFFLINE 设备下线消息
MESSAGE_DEVICE_MOTION 设备运动告警消息
MESSAGE_DEVICE_SOUND 设备声音告警消息
MESSAGE_DEVICE_SOMEONE 设备人脸识别告警消息

设备绑定解绑消息

从开放平台获取设备绑定消息。

消息类型：MESSAGE_DEVICE_BIND
消息类型：MESSAGE_DEVICE_UNBIND

消息结构

data:

参数名称 参数类型 参数含义 说明
deviceId String 设备id
tokenNum String token号

示例

设备绑定消息：

{
	"...": "...",
	"msgList": [{
		"msgType": "MESSAGE_DEVICE_BIND",
		"timeStamp": "1583317657000",
		"data": {
			"deviceId": "xxxxS_abcde",
			"tokenNum": "11654109845187"
		}
	}]
}

设备解绑消息：

{
	"...": "...",
	"msgList": [{
		"msgType": "MESSAGE_DEVICE_UNBIND",
		"timeStamp": "1583317657000",
		"data": {
			"deviceId": "xxxxS_abcde",
			"tokenNum": "11654109845187"
		}
	}]
}

设备上下线消息

从开放平台获取已绑定设备的上下线消息。

消息类型：
设备上线：MESSAGE_DEVICE_ONLINE
设备下线：MESSAGE_DEVICE_OFFLINE

消息结构

data:

参数名称 参数类型 参数含义 说明
deviceId String 设备id

示例

设备上线消息：

{
	"...": "...",
	"msgList": [{
		"msgType": "MESSAGE_DEVICE_ONLINE",
		"timeStamp": "1583317657000",
		"data": {
			"deviceId": "xxxxS_abcde",
			"onlineTime": "1579141371720"
		}
	}]
}

设备下线消息：

{
	"...": "...",
	"msgList": [{
		"msgType": "MESSAGE_DEVICE_OFFLINE",
		"timeStamp": "1583317657000",
		"data": {
			"deviceId": "xxxxS_abcde",
			"offlineTime": "1579141371720"
		}
	}]
}

设备告警消息

从开放平台获取设备告警消息。

消息类型：
运动告警消息：MESSAGE_DEVICE_MOTION
声音告警消息：MESSAGE_DEVICE_SOUND
人脸识别告警消息：MESSAGE_DEVICE_SOMEONE

消息结构

data:

参数名称 参数类型 参数含义 说明
deviceId String 设备id

示例

运动告警消息：

{
	"...": "...",
	"msgList": [{
		"msgType": "MESSAGE_DEVICE_MOTION",
		"timeStamp": "1583317657000",
		"data": {
			"deviceId": "xxxxS_abcde",
			"detectTime": "1584599831303"
		}
	}]
}

声音告警消息：

{
	"...": "...",
	"msgList": [{
		"msgType": "MESSAGE_DEVICE_SOUND",
		"timeStamp": "1583317657000",
		"data": {
			"deviceId": "xxxxS_abcde",
			"detectTime": "1584599831303"
		}
	}]
}

人脸识别告警消息：

{
	"...": "...",
	"msgList": [{
		"msgType": "MESSAGE_DEVICE_SOMEONE",
		"timeStamp": "1583317657000",
		"data": {
			"deviceId": "xxxxS_abcde",
			"detectTime": "1584599831303"
		}
	}]
}

← 调试工具 →