直播开放平台API接口调用对接说明
为了满足各行业用户使用监控视频直播业务需求,我公司拟定发布基于WEB方式,M3U8视频调用对接接口如下,前端需要部署我们智能网关,然后推流到我们云平台,支持市场主流监控摄像头厂商的接入,欢迎大家咨询交流,视频对接API开发包,请与我公司业务人员索取。
为了满足各行业用户使用监控直播业务需求,我公司直播开放平台拟定发布基于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 | 超过并发数或者欠费 |
直播开放平台API接口可用于网站、小程序、公众号、管理系统提供开放的API对接调用,详细可与客服微 信:ainsytone 手机:18028759876 沟通对接!