二、 API接口 2
2.1 获取设备列表 2
2.2 监看请求 3
三、 代码对照表 4
3.1 命令码 cmdID 4
3.2 响应码 result 4
一、概述
名称 | 获取设备列表 | 请求方式 | 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 |
ϖ 首次请求后,如果该视频未被其他人播放过,则可能需要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月
100-199 登录验证相关协议
200-499 媒体控制相关协议
500-999 设备控制相关协议
cmdID | 说明 |
100 | 登录验证 |
101 | 登录验证 - 返回 |
110 | 登录验证 - 多通道版 |
111 | 登录验证 - 多通道版 - 返回 |
200 | 监看请求 |
201 | 监看请求 - 返回 |
202 | 监看请求 - 多设备免登录 |
210 | 监看请求 - 多通道 |
300 | 云台控制指令 |
500 | 设备重启 |
501 | 获取设备状态 |
502 | 获取设备状态 - 返回 |
503 | 获取设备端配置 |
504 | 获取设备端配置 - 返回 |
506 | 更新设备端配置 |
result | 说明 |
0 | 成功 |
-1 | 其它错误 |
9 | 没有这个用户 |
10 | 用户已经在线 |
11 | 用户密码错误 |
50 | 设备不在线 |
57 | 请求被拒绝,设备未验证 |
73 | 转发服务器不在线 |
77 | 不在定时监看范围内 |
1019 | 超过并发数或者欠费 |