接口描述
默认接口请求频率限制：500次/秒。
查询NVR设备本地录像文件列表。
接口约束
- 查询本地录像文件列表，要确保该设备流是在线状态，方可正常查询。
- 开始时间和结束时间间隔需大于等于24小时。
URL
GET /v1?
请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeLocalRecords | 操作接口名，系统规定参数。 |
| InProtocol | String | 是 | gb28181 | 使用的接入协议。取值: gb28181 |
| DeviceId | String | 是 | 32388487739092995 | 设备ID。 |
| StartTime | Long | 是 | 1571639499 | 开始时间，默认为当天0点。unix时间戳，单位秒。 |
| EndTime | Long | 是 | 1571641299 | 结束时间，默认为当前时间。unix时间戳，单位秒。开始时间和结束时间间隔需大于等于24小时。 |
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| DeviceId | String | 设备ID。 |
| LocalRecords | LocalRecord[] | 本地录像文件列表。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
LocalRecord
| 参数 | 类型 | 描述 |
|---|---|---|
| StartTime | Long | 本地录像文件开始时间。 |
| EndTime | Long | 本地录像文件结束时间。 |
| Duration | Long | 本地录像文件时长，单位秒。 |
示例
请求示例
GET https://vss-dsp-gzgy2-a.ctapi.ctyun.cn/v1?Action=DescribeLocalRecords&DeviceId=572265668784914432&EndTime=1666713600&InProtocol=gb28181&StartTime=1666627200
Connection: keep-alive
ctyun-eop-request-id: f52880fe-bd10-4e7e-a0d2-c050a0772396
Eop-date: 20221025T102022Z
Eop-Authorization: BLLOJSUVKOZ7RVV9VEFF Headers=ctyun-eop-request-id;eop-date Signature=QHg+0BgFLLBdOONl2HGHlH57A4qKH7Mf/eN7SUY7GMw=
Host: vss-dsp-gzgy1-a.ctapi-test.ctyun.cn
User-Agent: Apache-HttpClient/4.5.13 (Java/11.0.14)
返回示例
{
"RequestId": "9fd9816d5a8d4bf9a0b0b7c6dae77ef7",
"DeviceId": "572265668784914432",
"LocalRecords": [
{
"StartTime": 1666661400,
"EndTime": 1666663199,
"Duration": 1799
},
{
"StartTime": 1666663200,
"EndTime": 1666664070,
"Duration": 870
}
]
}
