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

      • Add device
      • Device query
        • listDeviceDetailsByIds: Batch query of device details
        • listDeviceDetailsByPage: Paging device details for querying
        • deviceOnline: Get device online status
        • unBindDeviceInfo: Unbound device information acquisition
        • checkDeviceBindOrNot: Query device binding status
        • bindDeviceChannelInfo: Obtain the detailed information of a single device channel
        • deviceVersionList: Get device version and upgradeable information
        • deviceOpenList: Paging to obtain the basic information of the channel for adding devices to the open platform
        • queryOpenDeviceChannelInfo: Obtain the basic information of the channel for adding devices to the open platform
        • deviceOpenDetailList: Get detailed device information in batches
        • deviceBaseList: Paging to obtain the basic information of the device channel added or shared by the easy4ip app
        • queryBaseDeviceChannelInfo: Get the basic information of the channel added or shared by the easy4ip app
        • deviceBaseDetailList: Get detailed information of devices added or shared by easy4ip app in batches
        • shareDeviceList: Paging to get the device list shared by the easy4ip app to the developer
        • upgradeProcessDevice: Get device upgrade status and progress
        • listDeviceAbility: Obtain the ability set of multiple devices, channels and accessories in batch
        • subAccountDeviceInfo: Obtain the capability set of multiple devices, channels and accessories in batch
        • subAccountDeviceList: Get the capability set of multiple devices, channels and accessories in batch
      • Device maintenance
    • Device configurat

    • Video equipment

    • Device message
    • Device live broadcast
    • Device lock access
  • Reference documents

On this page
Function details
Request address
Incoming parameter description
Sample input
Return data field description
Sample output

Get Detailed Device Information in Batches - Imou Open Platform

deviceOpenDetailList: Get detailed device information in batches

Function details

Get detailed equipment information in batches based on the equipment serial number, channel number list, and accessory number list.

Note: To query the device bound to the easy4ip App, you need to obtain it through the deviceBaseDetailList interface.

Request address

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

Incoming parameter description

Parameter name Parameter type Is it required? Default value Legal value Parameter description
token String Yes Administrator accessToken
deviceList deviceId String Yes List of device serial numbers, up to 8 device queries are supported
channelList String Yes "1,2,3,4,5": Multiple channel numbers separated by commas List of channel numbers
apList String No "1,2,3,4,5": multiple part numbers separated by commas Accessory Id list

Sample input

{
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign":"71bd786471845583eeb412722aef79ac",
        "time":1603370757,
        "nonce":"1a411d5a-e88b-45ee-b590-53da98375edd"
    },
    "id":"beb24691-d173-473a-8d3d-92db3aee0027",
    "params":{
        "deviceList":[
            {
                "deviceId":"TESTQWERXXXX"
            }
        ],
        "token":"At_00000ad9e6e87f0142eb92e207aec46a"
    }
}

Return data field description

Field name Field type Field description
count Integer Number of devices queried this time
deviceList deviceId String Device serial number
status String Device status, online: online, offline: offline, sleep: hibernation, upgrading
deviceModel String Device model
catalog String Equipment category [NVR/DVR/HCVR/IPC/SD/IHG/ARC]
brand String Equipment brand information: lechange-easy4ip equipment, general-general equipment
version String Device software version number
name String Device name
ability String Equipment capability items, separated by commas, see device capability set for details
accessType String Device access type, PaaS-means Paas program access, Lechange-means easy4ip non-PaaS equipment, Easy4IP means Easy4IP program equipment, P2P means P2P program equipment
encryptMode String Encryption mode, 0: default encryption mode, 1: user-defined encryption mode
playToken String Device playback code, used by opensdk
channels channelId String Channel number
deviceId String Device serial number
channelName String Channel name
ability String Channel capability set, such as AlarmMD, AudioTalk, separated by commas
status String Remote channel status, online: online, offline: offline, close: not configured, sleep: hibernation, upgrading in progress
picUrl String Thumbnail URL
remindStatus String Reminder status, 0: no reminder, 1: reminder
cameraStatus String Mask status, on: open, off: closed
storageStrategyStatus String Cloud storage status, notExist: the package has not been activated, using: cloud storage has been activated and has not expired, expired: the package has expired
shareStatus String "": The device belongs to itself, share: Share to this user through the easy4ip app
shareFunctions String List of shared and authorized permission functions (separated by commas)
resolutions name String the name of the resolution displayed on the client interface
imageSize Integer resolution enumeration
streamType Integer stream type, 0: HD main stream, 1: SD secondary stream
aplist apId String Accessory id
apName String Accessory name
apType String Accessories type
apModel String Model of the accessory
ioType String The io type of the accessory, in: input, out: output
apVersion String The version number of the accessory
apStatus String Online status of accessories, online: online, offline: offline
apEnable String Enable the accessory, on: enable to open, off: enable to close
apCapacity String Accessory capability items, separated by commas, such as AudioTalk, PT

Sample output

{
    "result":{
        "msg":"The operation was successful.",
            "code":"0",
            "data":{
                "count":1,
                "deviceList":[{
                    "catalog":"ARC",
                    "deviceId":"DEVXXXXXXXXXXXX",
                    "version":"2.145.1000.0.R.20181112",
                    "aplist":[{
                        "apId":"APXXXXXXXXXXX",
                        "apName":"cname",
                        "apType":"ability",
                        "apModel":"wbs",
                        "ioType":"auto",
                        "apVersion":"V1.2.3",
                        "apStatus":"online",
                        "apEnable":"on",
                        "apCapacity":"AudioTalk,PT"
                    }],
                    "accessType":"PaaS",
                    "channels":[{
                        "channelId":"0",
                        "deviceId":"DEVXXXXXXXXXXXX",
                        "channelName":"channelName",
                        "ability":"ability",
                        "status":"online",
                        "picUrl":"http://xxx.xx.com/xxx/3.jpg",
                        "remindStatus":"0",
                        "cameraStatus":"on",
                        "storageStrategyStatus":"using",
                        "shareStatus":"share",
                        "shareFunctions":"videoMonitor",
                        "resolutions":[{
                            "name":"1080P",
                            "imageSize":18,
                            "streamType":0
                        }]
                    }],
                    "encryptMode":0,
                    "name":"TP1S-1842",
                    "deviceModel":"TP1S",
                    "ability":"WLAN,Auth,BreathingLight,CloudStorage,LocalStorage,PlaybackByFilename",
                    "brand":"lechange",
                    "playToken":"r3d9yLR2VmjQvDdweRmOaWdTNi1iqUHNCG7sZFQQbvRZ6zw==",
                    "status":"online"
                }]
            }
        },
    "id":"beb24691-d173-473a-8d3d-92db3aee0027"
}
queryOpenDeviceChannelInfo: Obtain the basic information of the channel for adding devices to the open platform
deviceBaseList: Paging to obtain the basic information of the device channel added or shared by the easy4ip app