1. 获取设备的异常信息

描述：

获取当前设备的异常信息，比如远程指令无法下发（网络波动、网络错误导致）、TF卡无法录像（卡片格式不对，或者TF卡内有碎片文件等）。

请求说明：

协议 方法 PATH
HTTPS POST /openApi/doorControlCamera/handleDeviceException

Body参数：

参数 类型 必填 说明
appId String 是 appId
expires String 是 过期时间
sign String 是 签名
deviceNo String 是 设备编号
cmd String 是 固定值：handleDeviceException
data String 是 空字符串，固定值：””

返回参数：

参数 类型 必填 说明
code int 是 响应状态码
msg String 是 响应消息
appId String 是 appId
expires String 是 过期时间
sign String 是 签名
deviceNo String 是 设备编号
cmd String 是 固定值：handleDeviceException
data String 是 data
- list String 是 事件的json array字符串
– exceptionType String 是 异常类型：1-有线网络，2-TF卡，3-云台，4-4G插入状态，5-wifi，6-蓝牙，7-无线模块连接状态（可后续拓展）
– exceptionCode String 是 状态码（详见下方说明）
– exceptionDesc String 是 描述信息

状态码说明：

状态码 含义
201 有线网络接入
202 有线网络断开
211 TF卡已经插入并且运行正常
212 TF卡已经插入但是读写运行异常
213 未检测到TF卡
221 云台接入
222 云台未接入
231 4G网络正常
232 未检测到4G网络接口
233 4G模块未连接
234 4G网络异常
241 wifi功能启用且已连接网络
242 wifi功能启用且未连接网络
243 wifi功能未启用
251 蓝牙功能启用
252 蓝牙功能关闭
261 无线发射模块已连接
262 无线发射模块未连接

请求示例：

{
  "appId": "ymn11bI3ujul6JZJ26",
  "expires": "1779853866",
  "sign": "1bb0f7147752f8fb7f4efc33df9726ee",
  "deviceNo": "5A2C60DB44",
  "cmd": "handleDeviceException",
  "data": ""
}

返回示例：

{
  "code": 0,
  "msg": "操作成功",
  "appId": "ymn11bI3ujul6JZJ26",
  "expires": "1779853977",
  "sign": "1bb0f7147752f8fb7f4efc33df9726ee",
  "deviceNo": "5A2C60DB44",
  "cmd": "handleDeviceException",
  "data": "{\"list\":\"[{\\\"exceptionType\\\":1,\\\"exceptionCode\\\":202,\\\"exceptionDesc\\\":\\\"有线网络已断开\\\"},{\\\"exceptionType\\\":2,\\\"exceptionCode\\\":212,\\\"exceptionDesc\\\":\\\"TF卡已经插入但是读写运行异常，请格式化后重试\\\"}]\"}"
}
作者：yrh  创建时间：2026-06-06 16:13
最后编辑：yrh  更新时间：2026-06-06 16:23