获取设备列表
# deviceList:获取设备列表
# 功能详情
分页获取开发者账号下有权限的设备详细信息列表。
注意:使用accessToken获取设备列表时,会同时抽取通过乐橙APP绑定的设备。
# 请求地址
https://openapi.lechange.cn/openapi/deviceList
# 传入参数说明
参数名 | 参数类型 | 是否必填 | 默认值 | 合法值 | 参数说明 |
---|---|---|---|---|---|
token | String | 是 | 管理员accessToken | ||
queryRange | String | 是 | 数字取值范围为:[1,N](N为正整数,且后者>前者); 差值取值范围为:[0, 99] | 第几条到第几条 |
# 样例输入
{
"system":{
"ver":"1.0",
"appId":"lcdxxxxxxxxx",
"sign":"d295752a8e075c9faf6ac356f01fe0e9",
"time":1599028453,
"nonce":"e2ab3938-971c-4791-893a-84a6c6a4fa9e"
},
"id":"e606cff7-6161-46b1-a8dd-543f84dd2809",
"params":{
"token":"At_00006ac6e32d123141238f60147de7ec",
"queryRange":"1-10"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
# 返回data字段说明
字段名 | 字段类型 | 字段说明 | ||
---|---|---|---|---|
count | Integer | 本次查询返回的设备总数 | ||
devices | deviceId | String | 设备序列号 | |
channelNum | Integer | 设备通道数 | ||
baseline | String | 设备基线类型 | ||
version | String | 设备软件版本号 | ||
encryptMode | Integer | 设备加密模式:0-设备默认加密 1-用户自定义加密 | ||
appId | String | 设备当前绑定的开发者信息,若为乐橙app绑定则返回空字符串 | ||
deviceCatalog | String | 设备大类(NVR/DVR/HCVR/IPC/SD/IHG/ARC) | ||
name | String | 设备名称 | ||
deviceModel | String | 设备型号 | ||
ability | String | 设备能力集 | ||
canBeUpgrade | Boolean | 设备软件程序是否有新版本可以升级 | ||
brand | String | 设备品牌信息:lechange-乐橙设备,general-通用设备 | ||
platForm | Integer | 设备接入平台编号:3-非pass设备,4-pass设备 | ||
status | Integer | 设备当前状态:0-离线,1-在线,3-升级中 | ||
channels | channelName | String | 设备通道名称 | |
channelOnline | Boolean | 设备通道在线状态:true-在线,false-离线 | ||
channelAbility | String | 设备通道能力集,单通道设备请以设备能力集为准 | ||
channelId | Integer | 设备通道号 | ||
channelPicUrl | String | 设备通道封面图,新设备可能不存在封面图,可上传设备通道封面图或者刷新设备封面图 | ||
csStatus | Integer | 云存储套餐状态:-1-未开通 0-已失效 1-套餐生效中 | ||
alarmStatus | Integer | 报警布撤防状态,0-撤防,1-布防,accessType=PaaS的需要通过bindDeviceInfo接口获取最新值 | ||
shareStatus | Boolean | 设备通道分享状态:true-设备通道已分享给其他用户,false-设备通道未分享给其他用户 |
# 样例输出
{
"result":{
"msg":"操作成功。",
"code":"0",
"data":{
"devices":[
{
"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,
"channelPicUrl":"",
"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
}
],
"count":1
}
},
"id":"e606cff7-6161-46b1-a8dd-543f84dd2809"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40