bindDeviceList (bindDeviceList: Get multiple device details)

bindDeviceList: bindDeviceList: Get multiple device details

Legacy HTTP retained: For existing integrations. New integrations should use the Device APIs overview.

Function details

Get detailed information for multiple devices the developer account is allowed to access.

Note: With an administrator accessToken you can query devices bound through the Imou app.

Request address

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

Request format

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

Incoming parameter description

Parameter name	Parameter type	Required or not	Default value	Legal value	Parameter description
token	String	Yes			Administrator accessToken
deviceIds	String	Yes			Comma-separated device serial numbers

Sample input

{
 "system":{
 "ver":"1.0",
 "appId":"lcdxxxxxxxxx",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "time":1599031404,
 "nonce":"fa264f82-110e-4531-989d-c5dad8bea7f3"
 },
 "id":"0252a6ad-a0f1-43fb-b2e8-eb2482930b32",
 "params":{
 "deviceIds":"TESTQWERXXXX",
 "token":"At_00006ac6e32d123141238f60147de7ec"
 }
}

Return data field description

Field name		Field type	Field description
deviceId		String	Device serial number
channelNum		Integer	Number of channels
baseline		String	Device baseline type
version		String	Device firmware version
appId		String	Bound developer appId; empty string when bound only via Imou app
deviceCatalog		String	Device category（NVR/DVR/HCVR/IPC/SD/IHG/ARC）
name		String	Device name
deviceModel		String	Device model
ability		String	Device capability set
canBeUpgrade		Boolean	Whether a newer firmware version is available
brand		String	Brand: lechange (Imou), general (generic)
platForm		Integer	Platform id: 3 standard access, 4 extended access (use bindDeviceInfo for latest fields when platForm=4)
status		Integer	Status: 0 offline, 1 online, 3 upgrading
encryptMode		Integer	Encryption mode: 0 device default, 1 user-defined
channels	channelName	String	Channel name
	channelOnline	Boolean	Channel online: true online, false offline
	channelAbility	String	Channel capability set; for single-channel devices use device-level capability set
	channelId	Integer	Channel number
	channelPicUrl	String	Channel cover image; may be missing on new devices (upload or refresh cover via current manage APIs)
	csStatus	Integer	Cloud storage: -1 not activated, 0 expired, 1 active
	alarmStatus	Integer	Alarm arming: 0 disarmed, 1 armed
	shareStatus	Boolean	Channel shared: true shared to others, false not shared

Sample output

{
 "result":{
 "msg":"Operation is successful.",
 "code":"0",
 "data":[
 {
 "channelNum":1,
 "baseline":"ARC",
 "deviceId":"TESTQWERXXXX",
 "version":"2.145.1000.0.R.20181112",
 "channels":[
 {
 "csStatus":-1,
 "alarmStatus":0,
 "channelName":"TP1S-1375",
 "channelOnline":true,
 "channelAbility":"PTZ,MDW,MDS,ChnLocalStorage",
 "channelId":0,
 "shareStatus":false
 }
 ],
 "encryptMode":0,
 "appId":"lcdxxxxxxxxx",
 "deviceCatalog":"ARC",
 "name":"TP1S-1375",
 "deviceModel":"TP1S",
 "ability":"WLAN,Auth,BreathingLight,CloudStorage,LocalStorage,PlaybackByFilename,MT,AGW,SLAlarm,CK,RD,LocalRecord,XUpgrade,TimeSync,ModifyPassword,LocalStorageEnable,RemoteControl,PTZ,Panorama,FrameReverse,AudioEncode,AudioEncodeControl,AlarmMD,MDW,MDS,AudioTalk,AlarmSound",
 "canBeUpgrade":false,
 "brand":"lechange",
 "platForm":4,
 "status":1
 }
 ]
 },
 "id":"0252a6ad-a0f1-43fb-b2e8-eb2482930b32"
}

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)

Code	Meaning	Next step
`SN1001`	Signature error	Check `sign` per Development specification
`TK1002`	Token invalid or expired	Refresh accessToken
`OP1002`	Missing required parameter	Add required fields
`OP1003`	Invalid parameter	Match this page’s parameter table
`OP1009`	Permission denied	Check token and device bind/share grants
`OP1013`	Total call limit exceeded	Reduce call rate
`OP1014`	Daily per-interface limit exceeded	See Interface call limits
`DV1007`	Device offline	Wait until the device is online

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

Sub-accounts (SUB)

Code	Meaning	Next step
`SUB1001`–`SUB1002`	Sub-account lacks API permission	Update policy via addPolicy
`SUB1005`	Sub-account token expired	Refresh subAccountToken
`SUB1006`	No device grant for sub-account	Check `Resource` and device serial
`SUB1008`	Sub-account not bound to app	Create and bind the sub-account first

See Return codes · SUB.

Device binding (DV10xx)

Code	Meaning	Next step
`DV1001`	Bound to another account	Unbind or use another device
`DV1002`	Device does not exist	Verify serial number
`DV1003`	Already bound to current account	No need to bind again
`DV1005`	Verification code error	Check device label code
`DV1008`	Bind count limit exceeded	Unbind extra devices
`DV1011`	Device not bound	Bind first
`DV1029`	Device already bound	Do not bind again

See Return codes · DV.