Getting Started
Official Site
Getting Started
Official Site
  • Document description
  • Read before you start

  • Light application development guide

  • Mobile application development guide

  • Cloud live development guide

  • Desktop application development guide

  • Third party development guide

  • Message push development guide

  • IoT things data model

  • HTTP interface

    • Development specification
    • API privacy policy
    • Postman interface simulation call
    • accessToken: Get administrator token
    • API request example
    • Account docking
    • Push configuration
    • Cloud storage service
    • Equipment management

    • Device configurat

    • Video equipment

      • Local recording
        • queryLocalRecordBitmap: Query local recording mask monthly
        • queryLocalRecordNum: Query the total number of local records of the device
        • queryLocalRecords: query local video clips of the device
      • Cloud video
    • Device message
    • Device live broadcast
    • Device lock access
  • Reference documents

On this page
Function details
Request address
Minimum permissions required for sub-account token request
Incoming parameter description
Sample input
Return data field description
Sample output

queryLocalRecords:Query local video clips of the device

queryLocalRecords:Query local video clips of the device

Function details

Query the local video clips of the specified type of the device / channel within the specified time period, and return the clips of the specified range.

Request address

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

Minimum permissions required for sub-account token request

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

Incoming parameter description

Parameter nameParameter typeRequired or notDefault valueLegal valueParameter description
tokenStringYesAdministrator or sub-account accessToken
deviceIdStringYesDevice serial number
channelIdStringYesChannel ID
beginTimeStringYesFormat: yyyy-MM-dd HH:mm:ssStart Time
endTimeStringYesFormat: yyyy-MM-dd HH:mm:ssEnd time
typeStringNo"All", that is, query all videosType
queryRangeStringYesThe value range is: [1, n] (n is a positive integer, and the latter > the former); the value range of difference is: [0, 29]Query range

Sample input

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

Return data field description

Field name Field type Field description
records recordId String Video file name
fileLength Long Video file length
channelID String Channel number
beginTime String Video begin time
endTime String Video end time
type String Video type

Sample output

{
    "result":{
        "msg":"The operation was successful.",
        "code":"0",
        "data":{
            "records":[{
                "recordId":"/mnt/sd/2020-05-19/001/dav/00/00.30.59-00.31.36[M][0@0][0].mp4",
                "fileLength":713883,
                "channelID":"0",
                "beginTime":"2020-05-19 00:30:59",
                "endTime":"2020-05-19 00:31:36",
                "type":"Event"
            }]
        }
    },
    "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af"
}
queryLocalRecordNum: Query the total number of local records of the device
queryCloudRecordBitmap: Query Cloud Recording Mask by Month