getCloudRecords: getCloudRecords: Query device cloud video clips in reverse order

Function details

Query all video records according to conditions (display in reverse order).

Request address

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

Request format

HTTP POST. JSON body layout: Request conventions. Sign with Signature.

Minimum permissions required for sub-account token request

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

Incoming parameter description

Query Strategy：

Sort the cloud video clips in descending order according to the begin and end time, and return the cloud video clip information of the previous count.

Time-window paging: In the next query, continue forward with the minimum beginTime of the previous batch as the new endTime (or beginTime minus one second).

Cursor paging: Pass recordId (default -1) and the previous page's nextRecordId / nextRecordRegionId to fetch the next page without changing beginTime / endTime.

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, count = 30, call getCloudRecords, and the platform returns 30 video clips.

step 2: Take the minimum beginTime(2021-12-01 10:30:00) of the video clip as the endTime input parameter for the next query, continue to call getCloudRecords, and cycle this operation.

step 3: When the minimum beginTime of video clips is less than or equal to the query begin time, or the number of video clips returned by getCloudRecords is less than the count value, the traversal can be considered to be completed.

Sample input

{
 "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "system":{
 "ver":"1.0",
 "appId":"lcdxxxxxxxxx",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "time":1599031074,
 "nonce":"8ec8a7bd1d1c95420de20d92422d457d"
 },
 "params":{
 "token":"At_12345678901234567890123456789012",
 "deviceId":"TESTQWERXXXX",
 "channelId":"0",
 "beginTime":"2016-05-19 00:00:00",
 "endTime":"2016-05-19 23:59:59",
 "count":30
 }
}

Return data field description

Sample output

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

Error codes

This method may return the codes below. See Return codes and Capability errors for the full catalog.

Gateway and auth (SN / TK / OP)

See Return codes · OP/SN/TK for the full catalog.

Sub-accounts (SUB)

See Return codes · SUB.

Device access and channels (DV10xx)

See Return codes · DV.

Cloud storage plans (ST)

See Return codes · ST.

Related

• Development specification
• API conventions
• Module index