查询GB28181设备的摄像机本地历史录像列表
更新时间：2023-03-07
接口描述
本接口用于查询GB28181设备的本地录像列表。
由于GB28181协议交互的原因，在首次请求时我们无法立即获取到摄像机的本地录像信息，所以此接口提供异步回调的方式通知录像查询结果。
可以用以下方式获取查询录像结果：
- 多次请求此接口，第一次请求作为触发查询动作，后续定时请求以获取实际结果。
- 采取异步回调的方式，在空间配置中接口指定一个HTTP回调地址。如果此刻还没有查询到结果，EVS将在查询到结果后将录像信息发送到这个地址；如果此刻已经有录像列表信息，将直接返回结果而不发回调。
请求（Request）
请求URI
GET /v1/device/channel/{channelId}/localRecording?begin={begin}&end={end}
| 参数名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| channelId | Long | 是 | 通道ID |
| begin | long | 是 | 开始时间 |
| end | long | 是 | 结束时间 |
| isSync | Boolean | 否 | 是否同步查询，默认false |
请求头域
除公共头域外，无其它特殊头域。
请求体
无。
响应（Response）
响应头域
除公共头域外，无其它特殊头域。
响应体
| 参数名称 | 类型 | 描述 |
|---|---|---|
| data | Array | 信息列表 |
| + title | String | 设备录像文件标题 |
| + playUrl | String | 录像播放链接 |
| + downloadKey | String | 录像下载的key，用于录像下载请求 |
示例
请求示例
POST /v1/device/channel/1000001/localRecording?begin=1623240120&end=1623240180 HTTP/1.1
x-bce-date: 2020-03-25T09:28:13Z
host: evs.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2020-03-25T09:28:13Z/1800/content-type;hostx-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715响应示例
- 未查询到结果
HTTP/1.1 202 Accepted
Transfer-Encoding: chunked
x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 202 013:34:07 GMT
Content-Type: application/json;charset=UTF-8- 查询到结果
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 202 013:34:07 GMT
Content-Type: application/json;charset=UTF-8
{
"data": [
{
"title": "2021.06.01 13:00:00-13:30:00",
"playUrl": "http://xxx.xxx/xxx/xxx.mp4",
"downloadKey": "MTAwMDAwMS8yMDIwLTA2LTI4VDExOjAwOjAwWi8yMDIwLTA2LTI4VDExOjMwOjAwWgo="
},
{
"title": "2021.06.01 13:30:01-14:00:00",
"playUrl": "http://xxx.xxx/xxx/xxx.mp4",
"downloadKey": "MTAwMDAwMS8yMDIwLTA2LTI4VDExOjMwOjAxWi8yMDIwLTA2LTI4VDEyOjAwOjAwWgo="
}
]
}错误码
参考公共错误码。