重庆市智慧工地数据中心接口之视频监控接口v3.0

智慧工地数据中心接口之

视频监控接口v3.0

1. 接口说明

视频监控接口较其他数据上传接口较为特殊，在监管平台中不会直接保存实际的视频数据，只在需要查看时通过供应商提供的接口去获取视频的播放地址，在接入时供应商需要像监管平台提交视频设备的基本信息（如下图1所示）；需要播放监控视频时，如果之前提交的视频基本信息中有可直接播放的视频地址(playUrl字段有值)则会直接调用该地址进行播放否则监管平台根据供应商提交的信息向供应商服务发起播放请求，获取视频的播放地址（如下图2所示）：

图1 视频供应商提交视频信息接口示意

图2 监管平台播放视频流程示意

视频监控播放接口实际是智慧工地信息管理平台向视频播放提供方的接口发起请求，接口采用 HTTP GET 方式，项目唯一编码及摄像头编号作为请求参数。视频播放提供方应返回对应的摄像头的视频播放地址。返回的视频流必须是一个HTML5兼容的格式（HLS），可以不借助其他插件直接在支持HTML5标准的浏览器（PC端/移动端）中播放。

智慧工地信息管理平台向视频播放提供方发起请求时同样会对请求进行签名，视频播放提供方应当按照权限认证接口中描述签名方式对请求签名进行验证，保证数据安全。

视频监控接入的接口分为两个部分：提交基本信息接口（视频摄像头清单上传接口）由智慧工地信息管理平台提供，供应商通过此接口上报视频监控摄像头的所属项目、编号、视频获取地址等信息；获取视频直播地址接口由供应商提供，监管平台需要播放视频时调用此接口，传入项目编号和设备编号等参数，获取指定监控设备的实时视频流播放地址。

2. 上传视频监控基本信息接口

此接口由监管平台提供，供应商向此接口提交项目上的视频监控设备信息。接口采用覆盖式更新的策略，根据项目密钥对定位项目后，会用本次提交的信息覆盖项目已有的信息。这样可以简化更新项目下的视频设备信息时的复杂度，但是要注意每次上传指定项目的视频设备信息时，都需要全量上传。

2.1. 接口地址

/api/open/iot/v3/video/info

2.2. 请求方法

HTTP POST

2.3. 请求内容

1. 请求头

请求头具体的生成方法请参考《智慧工地数据中心接口之认证鉴权接口》。

2. 请求体

请求体为JSON数据格式，内容为JSON对象数据，表示可以一次传入多行记录。格式如下：

注意：以上数据仅用于举例说明数据格式，各字段以项目实际数据为准。

视频播放会以camNo排序，且系统默认camNo最小的序号为项目主摄像头。

原则主摄像头应覆盖项目全貌。

各字段说明如下表：   

2.4. 返回值

2.5. 错误代码

3. 获取视频播放地址接口

此接口由供应商提供，接口地址应随视频设备基本信息提交到监管平台。监管平台在需要播放监控视频时，向供应商提供的接口发起请求，获得对应监控设备的视频流播放地址。

3.1. 接口地址

由供应商提供，随监控设备基本信息一起提交到监管平台。

3.2. 请求方法

HTTP GET

3.3. 请求内容

1. 请求头

请求头具体的生成方法请参考《智慧工地数据中心接口之认证鉴权接口》。本接口比较特殊，由监管平台计算签名，供应商平台验证签名。

2. 请求参数

请求参数由供应商在getUrl中自行处理，监管平台使用供应商上传的完整url调用，调用时监管平台不对url做任何修改。

3.4. 返回值格式

返回值说明如下表：

3.5. 错误代码