调用QueryRecord查询录像列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String QueryRecord

系统规定参数。取值:QueryRecord。

BeginTime Integer 1508200012

开始时间的秒数。

CurrentPage Integer 1

指定从返回结果第几页开始显示默认1。

EndTime Integer 1582420940

结束时间的秒数。

IotId String 12345

设备ID。可调用物联网平台QueryDeviceDetail查询。

PageSize Integer 10

每页条数,默认10,最大50。

RecordType Integer 1

录像类型:

  • 0:计划录像
  • 1:报警录像
  • 2:主动录像默认为
  • null:全部
StreamType Integer 1

码流类型:

  • 0(默认值):主码流
  • 1:辅码流

API调用的其他公共请求参数,请参见公共请求参数

返回数据

名称 类型 示例值 描述
RequestId String 06DC77A0-4622-42DB-9EE0-25FIOHS82JK1

请求ID。

Success Boolean true

表示是否调用成功:

  • true表示调用成功
  • false表示调用失败
ErrorMessage String XXXis mandatory for this action

调用失败时,返回的出错信息。

Code String MissingParamter

调用失败时,返回的错误码。

Data Struct

查询结果。

PageSize Integer 10

每页条数。

Page Integer 1

当前页码。

List Array

返回的录像列表。

BeginTime String 2018-09-10 00:00:00

录像开始时间。

EndTime String 2018-09-10 00:00:30

录像结束时间。

RecordType Integer 1

录像类型:

  • 0:计划录像
  • 1:报警录像
  • 2:主动录像默认为
  • null:全部
StreamType Integer 1

码流类型:

  • 0(默认值):主码流
  • 1:辅码流
FileName String file1

文件名。

FileSize Integer 204800

文件大小(字节)。

VideoFrameNumber Integer 1352

该段录像所含视频帧数

示例

请求示例

http(s)://[Endpoint]/?Action=QueryRecord
&BeginTime=1508200012
&CurrentPage=1
&EndTime=1582420940
&IotId=12345
&PageSize=10
&RecordType=1
&StreamType=1
&<公共请求参数>

正常返回示例

JSON 格式

{
    "QueryRecordResponse": {
        "RequestId": "06DC77A0-4622-42DB-9EE0-25FIOHS82JK1",
        "Success": true,
        "PageSize": 10,
        "Page": 1,
        "Total": 1,
        "PageCount": 1,
        "Data": {
            "RecordFiles": {
                "RecordFile": [
                    {
                        "BeginTime": "2018-09-10 00:00:00",
                        "EndTime": "2018-09-10 00:00:30",
                        "RecordType": 1,
                        "StreamType": 1,
                        "FileName": "file1",
                        "FileSize": 204800,
                        "VideoFrameNumber": 1352
                    },
                    {
                        "BeginTime": "2018-09-10 10:00:00",
                        "EndTime": "2018-09-10 10:00:30",
                        "RecordType": 1,
                        "StreamType": 1,
                        "FileName": "file2",
                        "FileSize": 204800,
                        "VideoFrameNumber": 1352
                    }
                ]
            }
        }
    }
}

XML 格式

<QueryRecordResponse>
  <RequestId>06DC77A0-4622-42DB-9EE0-25FIOHS82JK1</RequestId>
  <Success>true</Success>
  <PageSize>10</PageSize>
  <Page>1</Page>
  <Total>1</Total>
  <PageCount>1</PageCount>
  <Data>
      <RecordFiles>
                <RecordFile>
                      <BeginTime>2018-09-10 00:00:00</BeginTime>
                      <EndTime>2018-09-10 00:00:30</EndTime>
                      <RecordType>1</RecordType>
                      <StreamType>1</StreamType>
                      <FileName>file1</FileName>
                      <FileSize>204800</FileSize>
                      <VideoFrameNumber>1352</VideoFrameNumber>
                </RecordFile>
                <RecordFile>
                      <BeginTime>2018-09-10 10:00:00</BeginTime>
                      <EndTime>2018-09-10 10:00:30</EndTime>
                      <RecordType>1</RecordType>
                      <StreamType>1</StreamType>
                      <FileName>file2</FileName>
                      <FileSize>204800</FileSize>
                      <VideoFrameNumber>1352</VideoFrameNumber>
                </RecordFile>
      </RecordFiles>
  </Data>
</QueryRecordResponse>

错误码

访问错误中心查看更多错误码。