You need to enable JavaScript to run this app.
导航
慢直播
  • 文档首页
    • /
  • 慢直播

回放列表V2

最近更新时间：2023.07.06 15:25:38

首次发布时间：2023.07.06 15:25:38

我的收藏

查询设备本地录像回放列表。

请求方式

使用 POST 方式发起请求。

请求参数

下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表，参考「公共参数」。

字段
位置
类型
必填
说明
值
ActionQueryString是公共参数，OpenAPI 接口名称GetRecordListV2
VersionQueryString是公共参数，OpenAPI 接口版本2021-01-01

Body 参数

字段
类型
必填
说明
DeviceNSIDString是设备国标 ID，可通过调用 ListDevices 接口获取
ChannelIDString是通道 ID，可通过调用 ListStreams 接口获取（IPC 设备类型可以为空）
StartTimeInteger是查询起始时间，秒级时间戳，例如：1686153600
EndTimeInteger是查询结束时间，秒级时间戳，例如：1686182400

RecordType

String

否

录像类型：

  • time（定时录像）

  • alarm（报警录像）

  • manual（手动录像）

  • all（所有，默认）

TimeoutInSecInteger否查询超时时间，单位：秒

Order

Boolean

否

排序方式：

  • true（正序）

  • false（倒序）

返回结果

返回参数说明

通用返回参数，请参考 ResponseMetadata 结构体说明。

Result 字段包含以下参数：

字段
类型
说明
NumInteger查询到的记录数量
ItemArray of objects查询到的录像回放信息列表，参考以下 回放信息结构说明

回放信息结构说明

字段
类型
说明
ChannelIDString设备通道 ID
NameString录像名称
StartTimeString回放片段的开始时间
EndTimeString回放片段的结束时间
StartTimeStampInteger回放片段的开始时间的unix时间戳
EndTimeStampInteger回放片段的结束时间的unix时间戳

Secrecy

String

保密属性：

  • 0（不涉密）

  • 1（涉密）

TypeString录像类型
FileSizeString录像文件大小，单位：字节

示例

请求示例

POST https://open.volcengineapi.com?Action=GetRecordListV2
&Version=2021-01-01
&<公共请求参数>
{
    "DeviceNSID": "34020056991320xxxxxx",
    "ChannelID": "34020000001320000001",
    "StartTime": 1686153600,
    "EndTime": 1686182400,
    "RecordType": "all",
    "TimeoutInSec": 30, 
    "Order": true
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2022020809562401020404907915037F68",
        "Action": "GetRecordListV2",
        "Version": "2021-01-01",
        "Service": "aiotvideo",
        "Region": "cn-north-1"
    },
    "Result": {
        "Num": 1,
        "Item": [
            {
               "ChannelID": "34020000001320000001",
               "Name": "录像01",
               "StartTime": "2023-06-08T02:29:27",
               "EndTime": "2023-06-08T03:39:49",
               "StartTimeStamp": 1686162567,
               "EndTimeStamp": 1686166789,
               "Secrecy": "1",
               "RecordType": "time",
               "FileSize": "1000000"     
        ]
}