DSS 视频综合应用平台 http 接口
使用手册
2018 年 4 月
发布日期:2018 年 04 月 02 日
生效日期:2018 年 04 月 02 日
ZHEJIANG DAHUA
TECHNOLOGY
CO., LTD.
DSS 视频综合应用平台 http 接口
一. http 接口调用地址
(ip 为 DSS 服务器的 ip,port 为服务器的 web 端口)
http 接口采用 restful 风格提供数据接口,属于 post 提交,提交时提供 json 数据,后台会解
析
相应的 json 数据格式,并在 request 请求后作出相应 json 数据返回。
数据接口为:
1. 根据设备编号(deviceCode)查询该设备的状态。
http://ip:port/admin/rest/VideoStream/getDeviceStatus
2. 根据设备编号(deviceCode)、单元编号(unitSeq)、通道编号(chnSeq)、 码流
类型(streamType)获取实时的 HLS 播放地址。 其中,单元编号(unitSeq)传入的
值必须为 0 http://ip:port/admin/rest/VideoStream/getVideoStreamUrl
3. 根据设备编号(deviceCode)、单元编号(unitSeq)、通道编号(chnSeq)、码流类型
(streamType)、开始时间(BeginTime)、结束时间(EndTime)、录像存储位置(recordSource)
获取历史的 HLS 录像地址。
其中,单元编号(unitSeq)传入的值必须为 0、开始时间和结束时间的时间格式:
“YYYY-MM-DD hh:mm:ss”,开始时间要小于结束时
间。 http://ip:port/admin/rest/VideoStream/getVideo
未经同意 禁止拷贝
- 2 -
DSS 视频综合应用平台 http 接口
二. http 接口示例
1.
根据设备编号(deviceCode)查询该设备的状态。
<1>请求 url:
http://ip:port/admin/rest/VideoStream/getDeviceStatus
<2>传入参数格式
{
"dataDevice":{
"table":[
"deviceCode":"1000000"
//设备编号
{
}
]
}
}
<3>返回内容
{
"code": 1000,
"desc": "Success",
"data": {
"mapList": [
{
}
"deviceCode": "1000000",
"deviceStatus": "1"
]
}
}
<4>返回字段说明
deviceStatus:1 代表在线;0 代表离线。
未经同意 禁止拷贝
- 3 -
DSS 视频综合应用平台 http 接口
2.
获取实时的 HLS 播放地址
<1>请求 url:
http://ip:port/admin/rest/VideoStream/getVideoStreamUrl
<2>传入参数格式
{
"dataVideo":{
"table":[
"deviceCode":"1000000",
"unitSeq":"0",
"chnSeq":"12",
"streamType":"1"
//通道号(从 0 开始计算)
//1 代表主码流;2 代表辅码流
{
}
]
}
}
<3>返回内容
{
"code": 1000,
"desc": "Success",
"data": {
"mapList": [
{
"deviceCode": "1000000",
"unitSeq": "0",
"chnSeq": "12",
"streamType": "1",
"m3u8Url":
"http://127.0.0.1:7086/live/cameraid/1000000%2412/substream/1.m3u8"
}
]
}
}
未经同意 禁止拷贝
- 4 -
DSS 视频综合应用平台 http 接口
<4>返回字段说明
m3u8Url:实时预览拉流地址,地址中的 IP 地址可在平台管理员端参数配置处配置。
该请求平台不判断是否合理(即不判断是否真实存在通道),返回根据请求内容所组
装的 url 地址。
如下图:
3.
获取历史的 HLS 录像地址
<1>请求 url
http://ip:port/admin/rest/VideoStream/getVideo
<2>传入参数格式
{
"dataHistory":{
"table":[
"deviceCode":"1000000",
"chnSeq":"12",
"streamType":"1",
"beginTime":"2018-04-01 07:00:00",
"endTime":"2018-04-01 07:01:00",
"recordSource":"3"
//2 代表设备录像;3 代表中心录像
{
}
]
}
}
未经同意 禁止拷贝
- 5 -
DSS 视频综合应用平台 http 接口
<3>返回内容
{
"code": 1000,
"desc": "Success",
"data": {
"m3u8Url":
"http://172.22.101.116:7086/vod/center/cameraid/1000000%2412/substream/1
/totallength/60/begintime/1522537200/endtime/1522537260.m3u8"
}
}
<4>返回字段说明
m3u8Url:录像取流地址,当请求通道无录像时,返回内容为空。
三. 录像取流效果(vlc 播放器)
未经同意 禁止拷贝
- 6 -