queryCloudRecords: Query device cloud video clips in positive order

Function details

Query the cloud video clips of the device/channel in the specified time period, and return the clips in the specified range(display in positive order).

Request address

https://openapi-[DataCenter].easy4ip.com/openapi/queryCloudRecords

Minimum permissions required for sub-account token request

"Permission":"RecordReplay" "Resource":"cam:serial number:channel number"

Incoming parameter description

Parameter name	Parameter type	Required or not	Legal value	Parameter description
token	String	Yes		Administrator or sub-account accessToken
deviceId	String	Yes		Device serial number
channelId	String	Yes		Channel ID
beginTime	String	Yes		Start time, yyyy-MM-dd HH:mm:ss
endTime	String	Yes		End time, yyyy-MM-dd HH:mm:ss
queryRange	String	Yes		Query Range 1- N(N is a positive integer, and N>1); The maximum value of N is 100
cloudType	String	no	video: video recording; snapshot: snapshot recording.	recording type to query. Default value is video

Query Strategy：
Sort the cloud video clips in ascending order according to the begin and end time, and return the cloud video clip information of the previous queryRange (N value).
The next query can continue to query backward with the maximum endTime of the previous video clip as an input parameter.
Example：Traverse and query the video clip information from 10:00:00 of 2021-12-01 to 11:00:00 of 2021-12-01.
step 1: Set beginTime = 2021-12-01 10:00:00, endTime = 2021-12-01 11:00:00, queryRange = 1-100, call queryCloudRecords, and the platform returns 100 video clips.
step 2: Take the maximum endTime(2021-12-01 10:30:00) of the video clip as the beginTime input parameter of the next query, continue to call the queryCloudRecords, and cycle this operation.
step 3: When the maximum endTime of video clips is greater than or equal to the query end time, or the number of video clips returned by queryCloudRecords is less than queryRange (N value), the traversal can be considered to be completed.

Sample input

{
    "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign":"74bc756ebd53e9eef2836f8cf1730c10",
        "time":1599031074,
        "nonce":"8ec8a7bd1d1c95420de20d92422d457d"
    },
    "params":{
        "token":"At_12345678901234567890123456789012",
        "deviceId":"TESTQWERXXXX",
        "channelId":"0",
        "beginTime":"2020-05-19 00:00:00",
        "endTime":"2020-05-19 23:59:59",
        "queryRange":"1-100"
    }
}

Return data field description

Field name		Field type	Field description
records	recordId	String	Recording Id
	deviceId	String	Device serial number
	channelId	String	Channel number
	beginTime	String	Start time
	endTime	String	End time
	size	String	The size of cloud video (unit byte)
	thumbUrl	String	Thumbnail Url
	encryptMode	Integer	Encryption mode (0: default encryption mode; 1: user encryption mode)
	recordRegionId	String	Recording partition id

Sample output

{
    "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
    "result":{
        "data":{
	        "records":[
            {
                "recordId":"1234567890",
                "deviceId":"TESTQWERXXXX",
                "channelId":"0",
                "beginTime":"2020-05-19 00:30:59",
                "endTime":"2020-05-19 00:31:36",
                "size":"123456",
                "thumbUrl":"http://lechangecloud/20160519",
                "encryptMode":0,
                "recordRegionId":"xxxxxxxxx"
            }]
        },
        "code":"0",
        "msg":"successful operation"
    }
}