查询本地录像文件列表
最近更新时间：2025-02-21 02:50:53
1. 接口描述
接口请求域名: vssapi.ctyun.cn
默认接口请求频率限制：500次/秒。
查询NVR设备本地录像文件列表。
2. 请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeLocalRecords | 操作接口名，系统规定参数。 |
| InProtocol | String | 是 | gb28181 | 使用的接入协议。 取值: gb28181 |
| DeviceId | String | 是 | 32388487739092995 | 设备ID。 |
| StartTime | Long | 是 | 1571639499 | 开始时间，默认为当天0点。 unix时间戳，单位秒。 |
| EndTime | Long | 是 | 1571641299 | 结束时间，默认为当前时间。 unix时间戳，单位秒。 开始时间和结束时间间隔需大于等于24小时。 |
3. 返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| DeviceId | String | 设备ID。 |
| LocalRecords | LocalRecord[] | 本地录像文件列表。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
LocalRecord
| 参数 | 类型 | 描述 |
|---|---|---|
| StartTime | Long | 本地录像文件开始时间。 |
| EndTime | Long | 本地录像文件结束时间。 |
| Duration | Long | 本地录像文件时长，单位秒。 |
4. 示例
4.1 请求示例
https://vssapi.ctyun.cn/
?Action=DescribeLocalRecords
&InProtocol=gb28181
&DeviceId=32388487739092995
&Version=2020-06-12
&AccessKeyId=O0G0BPBI2T9YUD3U****
&Signature=b5Gv5U2hlTHgeEaKE9KgVoo6DWw%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=1578406
&SignatureVersion=1.0
&Timestamp=1599113545
4.2 返回示例
{
"DeviceId": "32388487739092995",
"LocalRecords": [
{
"StartTime": 1571639499,
"EndTime": 1571641298,
"Duration": 1800,
},
{
"StartTime": 1571641299,
"EndTime": 1571643098,
"Duration": 1800,
}
],
"RequestId": "3247575e6e1044668962f5a464fa3885"
}
5. 错误码
| ErrorCode | ErrorMessage |
|---|---|
本页目录：