为了满足各行业用户使用监控直播业务需求,我公司拟定发布基于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 |
-
- 二.2 监看请求
ϖ 首次请求后,如果该视频未被其他人播放过,则可能需要10秒左右准备视频文件,此时播放地址可能暂时失效,需要业务里设置重新加载的逻辑;
ϖ 之后每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 |
更新于:2019年09月
-
- 三、代码对照表
- 三.1 命令码 cmdID
100-199 登录验证相关协议
200-499 媒体控制相关协议
500-999 设备控制相关协议
cmdID |
说明 |
100 |
登录验证 |
101 |
登录验证 - 返回 |
110 |
登录验证 - 多通道版 |
111 |
登录验证 - 多通道版 - 返回 |
200 |
监看请求 |
201 |
监看请求 - 返回 |
202 |
监看请求 - 多设备免登录 |
210 |
监看请求 - 多通道 |
300 |
云台控制指令 |
500 |
设备重启 |
501 |
获取设备状态 |
502 |
获取设备状态 - 返回 |
503 |
获取设备端配置 |
504 |
获取设备端配置 - 返回 |
506 |
更新设备端配置 |
-
- 三.2 响应码 result
result |
说明 |
0 |
成功 |
-1 |
其它错误 |
9 |
没有这个用户 |
10 |
用户已经在线 |
11 |
用户密码错误 |
50 |
设备不在线 |
57 |
请求被拒绝,设备未验证 |
73 |
转发服务器不在线 |
77 |
不在定时监看范围内 |
1019 |
超过并发数或者欠费 |