TSINGSEE青犀视频平台调用接口常见问题及注意事项汇总

Posted 2021-12-09 TSINGSEE

TSINGSEE青犀视频平台均包含很多二次开发接口，很多功能都可以通过接口调用来实现。比如EasyGBS的接口文档如下：

在使用过程中，很多客户是利用我们平台的接口集成到自己的视频平台，以此对外进行展示，那么在调用接口的过程中会出现很多问题，例如：接口不生效、调用受限、演示无法播放等等。本文我们就简单介绍一下出现这些问题常见的调整方法。

1、接口调用是否需要先登录

是否需要登录取决于“接口鉴权”是否开启。如果接口鉴权开启，那么都要先执行登录，获取token，然后重启下服务即可；如果“接口鉴权”未开启，即可直接调用接口。

2、调用设备接口时要注意以下事项

A、首先要Post请求

添加设备接口和其他的接口不同，是post请求，因此不能同其他接口一样，直接将接口写在请求连接上，而是需要将post请求写在body里面。

B、参数传递

在传递参数的时候一定需要将所有的参数都传上，不能因为某个参数没有值就不填写，即使传空值也需要将参数全部填写进去，否则会出现404的情况。

3、调用录像接口注意事项

A、通过获取设备信息接口和通道信息接口先获取到设备的deviceid和channelid，然后先调用播放接口。注意这里必须先调用播放接口，再调用录像接口。
B、然后开始调用开始实时录像接口，输入channel参数，返回OK证明已经开始实时录像了。
C、接着调用关闭实时录像接口，输入channel参数，会返回一个url地址。
D、将这个地址在浏览器上面打开后，就能下载录像文件了（注意前面要加ip和端口）。