subAccountDeviceInfo（获取子账号下指定的授权设备详细信息）

subAccountDeviceInfo：获取子账号下指定的授权设备详细信息

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

获取子账号下指定的授权设备详细信息，仅限子账号token调用

请求参数

参数名		参数类型	是否必填	合法值	参数说明
token		String	是		子账号token
deviceList	deviceId	String	是		设备序列号列表，最大支持8个设备查询
	channelList	String	否	"1,2,3,4,5":多个通道号逗号隔开，为空时查询所有设备通道	通道号列表
	apList	String	否	"1,2,3,4,5":多个配件号逗号隔开	配件Id列表

请求示例

{
  "system": {
    "ver": "1.0",
    "appId": "lcdxxxxxxxxx",
    "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
    "time": 1626313585,
    "nonce": "93686fc7-153e-41b7-924b-834a901b98b4"
  },
  "id": "4f1dead2-ff99-49a7-a996-e996d56711b9",
  "params": {
    "deviceList": [
      {
        "channelList": "0",
        "apList": "0,1",
        "deviceId": "TESTQWERXXXX"
      }
    ],
    "token": "<yourAccessToken>"
  }
}

响应字段

字段名				字段类型	字段说明
deviceList	deviceId			String	设备序列号
	status			String	设备状态，online：在线，offline：离线，sleep：休眠，upgrading升级中
	deviceModel			String	设备型号
	catalog			String	设备大类【NVR/DVR/HCVR/IPC/SD/IHG/ARC】
	version			String	设备软件版本号
	name			String	设备名称
	permission			String	设备权限，若只授权通道级别权限，则此字段不返回内容
	ability			String	legacy 能力串（逗号分隔）。新接入看 V2 [device.capability.list](/api/device.capability.list/) 的 `capabilityIds`；对照 [遗留能力集](/api/legacy/ability-switch/)
	accessType			String	设备接入类型，PaaS-表示Paas程序接入、Lechange-表示乐橙非PaaS设备、Easy4IP表示Easy4IP程序设备、P2P表示P2P程序设备
	encryptMode			String	加密模式，0：默认加密模式，1：用户自定义加密模式
	channelNum			String	设备可接入通道数量
	channels	channelId		String	通道号
		channelName		String	通道名称
		ability		String	通道能力集，如AlarmMD,AudioTalk，逗号隔开
		status		String	远程通道状态，online：在线，offline：离线，close：未配置，sleep：休眠，upgrading升级中
		permission		String	通道权限，若只授权设备级别权限，则按照设备级别权限填充
		picUrl		String	缩略图URL
		resolutions	name	String	客户端界面展示的分辨率名称
			imageSize	Integer	分辨率枚举
			streamType	Integer	码流类型，0：主码流，1：辅码流
	aplist	apId		String	配件id
		apName		String	配件名称
		apType		String	配件类型
		apModel		String	配件的型号
		ioType		String	配件的io类型，in：输入，out：输出
		apVersion		String	配件的版本号
		apStatus		String	配件的在线状态，online：在线，offline：离线
		apEnable		String	配件的使能，on：使能开启，off：使能关闭
		apCapacity		String	配件能力项，逗号隔开，如AudioTalk,PT

响应示例

{
  "result": {
      "msg": "操作成功。",
      "code": "0",
      "data": {
          "deviceList": [{
              "accessType": "PaaS",
              "catalog": "NVR",
              "encryptMode": 0,
              "name": "NVR-4993",
              "channelNum": "64",
              "deviceModel": "DH-NVR5232-I",
              "permission": "",
              "ability": "Auth,DHP2P,CloudStorage,  LocalStorage,PlaybackByFilename,MT,CK,RD",
              "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"
}

错误码

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

网关与鉴权（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。

说明

仅限子账号 accessToken 调用；须使用本子账号签发的 token，且 token 已具备目标设备的授权。管理员 token 不可调用。

新接入查子账号设备详情推荐按 ID 批量详情 / 分页详情（子账号 token + openid），返回 capabilityIds 等与主账号 pipeline 一致。本页为 legacy /openapi/subAccountDevice*，保留 ability/channels 等旧字段形态。