萤石开放平台——如何对摄像头消息做二次开发

摄像头的告警消息通常可以通过已有的萤石云视频app端接收，但还是希望消息上报到开发者自己的平台上，开发者配置消息推送业务后，场景内发生异常情况时，消息上报可以让使用者及时收到消息，防止危险事件发生，为自身业务提供安全保证。

准备工具：

注册萤石开放平台账号：https://open.ys7.com/cn/s/index

萤石开放平台控制台-网页链接：登录-用户认证中心

下载postman：测试接口调用是否成功，下载地址：Download Postman | Get Started for Free

获取accesstoken：登录-用户认证中心

Step1:登录萤石开放平台

Step2:进入萤石开放平台—控制台

 

 Step3:进入控制台—产品中心—消息推送—点击立即开通

Step4:填写消息推送配置信息

必填信息：

（1）消息类型：目前平台支持6种消息类型上报，建议全部开通

（2）Webhook回调地址：自定义回调地址（客户系统）

（3）失败重试最大次数：消息推送失败后，重复推送的次数

Step5:打开postman调用消息通道相关接口

参考接口文档：文档概述 · 萤石开放平台API文档

接口编号	接口名称	接口URL
1001	创建消费者	https://open.ys7.com/api/lapp/mq/v2/consumer/{consumerName}
1002	消费者消费消息	https://open.ys7.com/api/lapp/mq/v2/consumer/messages

1、创建消费者（1001）

请求地址

https://open.ys7.com/api/lapp/mq/v2/consumer/{consumerName}

注：（1）consumerName表示租户组名，名称固定为group1至group5，传入其他参数报错。

例如：请求地址：https://open.ys7.com/api/lapp/mq/v2/consumer/group1

（2）标红字段需按照真实情况进行修改

请求方式

POST

请求参数

参数名	数据类型	描述
accessToken	String	开放平台授权过程获取的访问令牌，获取方式参考接口 https://open.ys7.com/help/81

请求报文

POST /api/lapp/mq/v2/consumer/group1  HTTP/ 1.1 Host: open.ys7.com  Content-Type: application/x-www-form-urlencoded  accessToken=at.dunwhxt2azk02hcn7phqygsybbw0wv6p

接口调用具体操作：

（1）打开postman，选择POST请求格式，输入请求地址

（2）配置参数：KEY：accesstoken；VALUE：真实的accesstoken

（3）输入请求报文

（4）返回数据，得到consumerId

 

2、消费者消费消息（1002）

请求地址

https://open.ys7.com/api/lapp/mq/v2/consumer/messages

请求方式

POST

请求参数

参数名	数据类型	描述	是否必选
accessToken	String	开放平台授权过程获取的访问令牌，获取方式参考接口 https://open.ys7.com/help/81	Y
consumerId	String	消费者在组中唯一标识，5分钟内未使用将自动删除，断开和消息通道的链接	Y
offset	Int	偏移量	N

 

 

注：consumerId表示消费者在组中唯一标识，5分钟内未使用将自动删除，断开和消息通道的链接，需重新获取。

请求报文

POST /api/lapp/mq/v2/consumer/messages HTTP/ 1.1  Host: open.ys7.com  Content-Type: application/x-www-form-urlencoded  accessToken=at.dunwhxt2azk02hcn7phqygsybbw0wv6p&consumerId=fab41dc1ea1043e3ad7285c96df05517

接口调用具体操作：同上

 

 Step6:用户将返回数据进行解析，应用于自身开发的客户端。