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
The sub-account token can request any permission
Incoming parameter description
Sample input
Return data field description
Sample output

bindDeviceChannelInfo - Obtain Device Channel Information - Imou Open Platform

bindDeviceChannelInfo: Obtain the detailed information of a single device channel

Function details

Get information about a single device channel.

Request address

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

The sub-account token can request any permission

"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

Sample input

{
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign":"66e3c999d175d9296822f3e80322c600",
        "time":1603370040,
        "nonce":"abd1e79d-d3b5-4760-959e-e7959a22cb5e"
    },
    "id":"65f772cf-ad91-49a5-aa90-bb344e3e0f7c",
    "params":{
        "deviceId":"TESTQWERXXXX",
        "channelId":"0",
        "token":"At_00000ad9e6e87f0142eb92e207aec46a"
    }
}

Return data field description

Field name Field type Field description
deviceId String Device serial number
alarmStatus Integer Motion check switch state 0: closed state, 1: open state
channelId Integer Device channel number
channelName String Channel name
channelOnline String Whether it is online, online-online offline-offline close-not configured sleep-hibernation is upgrading
channelPicUrl String Thumbnail URL, new devices can update the field by refreshing the device channel cover image or uploading the device channel cover image
shareStatus String "": The device belongs to itself; "share": Share to this user through Lecheng app; "auth": Authorize to this user through Lecheng PC client; "shareAndAuth": Share to this user through Lecheng app And authorized to this user through easy4ip PC client
shareFunctions String Optional, a list of permissions and functions to be shared and authorized (separated by commas)
csStatus 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

Note: When there is no channel on the device, the interface only returns the deviceId field, other fields do not return

Sample output

{
  "result":{
    "msg":"The operation was successful.",
    "code":"0",
    "data":{
      "csStatus":"notExist",
      "shareFunctions":"",
      "alarmStatus":1,
      "channelName":"TP1S-1842",
      "channelOnline":"online",
      "channelAbility":"PTZ,MDW,MDS,ChnLocalStorage",
      "deviceId":"TESTQWERXXXX",
      "channelId":0,
      "channelPicUrl":"",
      "shareStatus":""
    }
  },
  "id":"65f772cf-ad91-49a5-aa90-bb344e3e0f7c"
}
checkDeviceBindOrNot: Query device binding status
deviceVersionList: Get device version and upgradeable information