小程序、微信公众号调用监控摄像头直播开放接口文档

    为了满足各行业用户使用监控视频直播业务需求，云事通公司拟定发布基于WEB方式，M3U8视频调用对接接口如下，前端需要部署我们智能网关，然后推流到我们云平台，支持市场主流监控摄像头厂商的接入，欢迎大家咨询交流，视频对接API开发包，请与我公司业务人员索取。

监控直播开放接口文档 1

一、 概述 2

二、 API接口 2

2.1 获取设备列表 2

2.2 监看请求 3

三、 代码对照表 4

3.1 命令码 cmdID 4

3.2 响应码 result 4

• 概述

 

• API接口
  1. 获取设备列表

名称	获取设备列表			请求方式	GET | POST
URL	(http|https)://cdn88.cn/api/
功能描述	获取用户账号下设备列表：播放地址、缩略图、名称、SN
请求参数	类型	默认值	必填	参数说明
cmdId	number	100	是	指令代码，未指定则默认100
ip	string			服务器ip，非自建服务器请留空
user	string		是	登录账号
password	string	‘’		登录密码(支持MD5)，默认空密码
dev	string	null		设备SN，默认返回账号下所有设备，指定设备则用逗号隔开SN
返回参数	类型	默认值	必填	参数说明
cmdId	number	101	是	指令代码
result	number		是	0正常，其它异常状态参考代码对照表result
devlist	array			result=0时返回，[{},{},...]
+ip	string			设备连接的流媒体服务器ip
+sn	number			设备序列号SN
+port	number			协议端口
+flsPort	number			FLASH方式播放端口
+devid	number			设备ID
+name	string			设备名称
+hlsurl	string			hls播放地址
+imgsrc	string			缩略图地址
+state	number			设备状态，0=正常，其它异常参考代码对照表result

1. 1. 监看请求
2. 首次请求后，如果该视频未被其他人播放过，则可能需要10秒左右准备视频文件，此时播放地址可能暂时失效，需要业务里设置重新加载的逻辑；
3. 之后每5分钟保持一次请求，否则会停止生成视频文件，播放地址失效

名称	监看请求			请求方式	GET | POST
URL	(http|https)://cdn88.cn/api/
功能描述	通知服务器准备播放所需的视频文件
请求参数	类型	默认值	必填	参数说明
cmdId	number	200	是	指令代码
ip	string			服务器ip，非自建服务器请留空
user	string		是	登录账号
password	string	‘’		登录密码(支持MD5)，默认空密码
dev	string		是	监看设备的SN
返回参数	类型	默认值	必填	参数说明
cmdId	number	201	是	指令代码
result	number		是	0正常，其它异常状态参考代码对照表result

 

• 代码对照表
  1. 命令码 cmdID

100-199 登录验证相关协议

200-499 媒体控制相关协议

500-999 设备控制相关协议

cmdID	说明
100	登录验证
101	登录验证 - 返回
110	登录验证 - 多通道版
111	登录验证 - 多通道版 - 返回
200	监看请求
201	监看请求 - 返回
202	监看请求 - 多设备免登录
210	监看请求 - 多通道
300	云台控制指令
500	设备重启
501	获取设备状态
502	获取设备状态 - 返回
503	获取设备端配置
504	获取设备端配置 - 返回
506	更新设备端配置

1. 1. 响应码 result

result	说明
0	成功
-1	其它错误
9	没有这个用户
10	用户已经在线
11	用户密码错误
50	设备不在线
57	请求被拒绝,设备未验证
73	转发服务器不在线
77	不在定时监看范围内
1019	超过并发数或者欠费

更新于：2019年09月