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

SubAccountDeviceList - Authorized Device Details by Page - Imou Open Platform

subAccountDeviceList: Get detailed information of authorized devices under sub-accounts by page

Function details

Get the detailed information of authorized devices under the sub-account by page, only the sub-account token can be called

Request address

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

Incoming parameter description

Parameter name Parameter type Is it required? Default value Legal value Parameter description
token String Yes Subaccount Token
page Integer No 1 Integer greater than 1 Pagination parameters, which page
pageSize Integer No 10 1-20 Pagination parameters, number per page

Sample input

{
  "system": {
    "ver": "1.0",
    "appId": "lcdxxxxxxxxx",
    "sign": "d4c0ec1f5aad5ed87d3fc93b09f30bb5",
    "time": 1623987465,
    "nonce": "39ed36aa-1fac-4e80-83c9-3b457db70ecd"
  },
  "id": "733b6b5c-05ce-4734-b407-e30dac44e637",
  "params": {
    "pageSize": 1,
    "page": 2,
    "token": "St_0000dc28d3ac63bf4cb5ad0e7e2ba731"
  }
}

Return data field description

Field name Field type Field description
count Integer Total amount of equipment
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]
version String Device software version number
name String Device name
permission String Device permissions, if only channel-level permissions are authorized, this field does not return content
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
channelNum String The number of channels that the device can access
channels channelId String Channel 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
permission String Channel authority, if only the device level authority is authorized, fill in according to the device level authority
picUrl String Thumbnail URL
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": 2,
            "deviceList": [{
                "accessType": "PaaS",
                "catalog": "NVR",
                "encryptMode": 0,
                "name": "NVR-4993",
                "channelNum": "64",
                "deviceModel": "DH-NVR5232-I",
                "permission": "",
                "ability": "Auth,DHP2P,CloudStorage,LocalStorage,PlaybackByFilename",
                "deviceId": "TESTQWERXXXX",
                "version": "2.145.1000.0.R.20181112",
                "status": "offline",
                "channels": [{
                    "picUrl": "",
                    "channelName": "NVR-4993-4",
                    "permission": "Alarm,Talk,Ptz,Config,Upgrade",
                    "ability": "PTZ,MDW,MDS,ChnLocalStorage",
                    "channelId": "3",
                    "status": "offline",
                    "resolutions":[{
                        "name": "1080P",
                        "imageSize": 18,
                        "streamType": 0
                    }]
                }],
                "aplist":[{
                    "apId":"APXXXXXXXXXXX",
                    "apName":"cname",
                    "apType":"ability",
                    "apModel":"wbs",
                    "ioType":"auto",
                    "apVersion":"V1.2.3",
                    "apStatus":"online",
                    "apEnable":"on",
                    "apCapacity":"AudioTalk,PT"
                }]
            }]
        }
    },
    "id": "733b6b5c-05ce-4734-b407-e30dac44e637"
}
subAccountDeviceInfo: Obtain the capability set of multiple devices, channels and accessories in batch
modifyDeviceName: Modify device or channel name