listDeviceAbility（批量获取多个设备、通道以及配件的能力集）

listDeviceAbility：批量获取多个设备、通道以及配件的能力集

新接入请使用查询可用能力 device.capability.list，再按设备能力与事件参考调用具体能力。本页保留给仍在调用 POST /openapi/listDeviceAbility 的兼容对接，不表示该地址已经下线。

要点：https://openapi.lechange.cn/openapi/listDeviceAbility · 见错误码

批量获取多个设备、通道以及配件的能力集。deviceList 最多 32 台；channelList / apList 可选，按需传通道号或配件 ID 逗号串。V2 device.capability.list 为单设备查询，批量请循环调用；legacy 返回 WLAN,PTZ,… 码表，迁移时对照设备能力集（遗留）与能力目录 propertyId。

请求参数

参数名		参数类型	是否必填	合法值	参数说明
token		String	是		管理员accessToken
deviceList	deviceId	String	是		设备序列号（`deviceList` 数组单次 ≤32 台）
	channelList	String	是	"1,2,3,4,5":多个通道号逗号隔开	通道号列表
	apList	String	否	"1,2,3,4,5":多个配件号逗号隔开	配件Id列表

请求示例

{
    "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
        "time": 1706511734,
        "nonce": "f5a1ae2d-c09c-4d39-a744-83a5c2c653c2"
    },
    "params":{
        "token": "<yourAccessToken>",
        "deviceList":[{
            "deviceId":"TESTQWERXXXX",
            "channelList":"0",
            "apList":"TESTQWERXXXX"
        }]
    }
}

响应字段

字段名			字段类型	字段说明
deviceList	deviceId		String	设备序列号
	ability		String	设备能力项，英文逗号分隔，详见设备能力定义
	channels	channelId	String	通道号
	channels	channelAbility	String	通道能力集，英文逗号分隔，如AlarmMD,AudioTalk
	aps	apId	String	配件id
	aps	apAbility	String	配件能力项，英文逗号分隔，如AudioTalk,PT

响应示例

{
    "result": {
        "msg": "操作成功。",
        "code": "0",
        "data": {
            "deviceList": [
                {
                    "channels": [
                        {
                            "channelAbility": "WLAN,MT,HSEncrypt,CloudStorage,LocalStorage,PlaybackByFilename,BreathingLight,RD,LocalRecord,XUpgrade,Auth,ModifyPassword,LocalStorageEnable,RTSV1,PBSV1,ESV1,PlaySound,Reboot,InfraredLight,LinkDevAlarm,AbAlarmSound,SCCode,RDV2,CK,AlarmMD,PT,AudioEncodeControlV2,FrameReverse,RemoteControl,MDW,MDS,HeaderDetect,SmartTrack,CloseCamera,CheckAbDecible,PT1,AudioTalk",
                            "channelId": "0"
                        }
                    ],
                    "aps": [],
                    "ability": "WLAN,MT,HSEncrypt,CloudStorage,LocalStorage,PlaybackByFilename,BreathingLight,RD,LocalRecord,XUpgrade,Auth,ModifyPassword,LocalStorageEnable,RTSV1,PBSV1,ESV1,PlaySound,Reboot,InfraredLight,LinkDevAlarm,AbAlarmSound,SCCode,RDV2,CK,AlarmMD,PT,AudioEncodeControlV2,FrameReverse,RemoteControl,MDW,MDS,HeaderDetect,SmartTrack,CloseCamera,CheckAbDecible,PT1,AudioTalk",
                    "deviceId": "TESTQWERXXXX"
                }
            ]
        }
    },
    "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af"
}

错误码

本接口可能返回下列码；完整分组见错误码。

网关与鉴权（SN / TK / OP）

错误码	错误码说明	下一步
`SN1001`	签名异常	按签名核对 `sign`
`TK1002`	token 无效或过期	重新获取 token
`OP1002`	缺少必填参数	补必填字段
`OP1003`	参数不合法	按本页参数表核对
`OP1039`	分钟级限流	等到下一分钟再试
`OP1040`	调用超限	降低频率
`DV1007`	设备离线或超时	等设备上线

子账号（SUB）

错误码	错误码说明	下一步
`SUB1001`	子账号无指定权限	在子账号策略中补权限
`SUB1002`	子账号无任何设备权限	授权设备或调整策略
`SUB1005`	子账号 token 过期	重新获取子账号 token
`SUB1006`	子账号与设备无授权关系	核对 `Resource` 与设备序列号
`SUB1008`	子账号未绑定当前应用	先创建并绑定子账号
`SUB1007`	创建子账号失败	核对参数后重试
`SUB1009`	子账号创建失败，账号格式错误	`account` 须为手机号或邮箱
`SUB1010`	子账号创建失败，账号已存在	勿重复绑定同一子账号到应用

更多见错误码 · SUB。

设备访问与通道（DV10xx）

错误码	错误码说明	下一步
`DV1007`	设备离线或超时	等设备上线；低电休眠先唤醒
`DV1009`	设备正忙	稍后重试
`DV1012`	分享/授权设备权限不足	核对子账号 `Permission` / `Resource`
`DV1019`	能力集不支持	确认型号与设备能力
`DV1020`	通道离线	检查通道与设备状态
`DV1026`	不支持此功能	换接口或升级固件
`DV1028`	未绑定或通道不存在	核对 `deviceId` / `channelId`
`DV1030`	设备休眠	唤醒后再调
`DV1057`	通道不存在	核对通道号
`DV1061`	设备响应超时	检查设备网络
`DV1062`	需先唤醒设备	调用唤醒接口
`DV1069`	不满足操作条件	见 `msg`

说明

支持管理员或子账号 accessToken。子账号须在策略中授予对应设备/通道权限，配置见权限码。

本接口属于旧版协议。新接入使用 device.capability.list。