deviceAlarmPlan（获取设备报警计划）

新接入请优先使用设备能力与事件与 V2 设备 API。本页保留给仍在调用 POST /openapi/deviceAlarmPlan 的兼容对接。

deviceAlarmPlan：获取设备报警计划

要点：https://openapi.lechange.cn/openapi/deviceAlarmPlan · 权限 "Permission":"Config" "Resource":"cam:序列号:通道号" · 见错误码

获取设备报警计划。

请求参数

参数名	参数类型	是否必填	参数说明
token	String	是	管理员或者子账号accessToken
deviceId	String	是	设备序列号
channelId	String	是	通道号

请求示例

{
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
        "time":1603355564,
        "nonce":"799af85b-56d7-47df-b010-f9ff898048f1"
    },
    "id":"6a60a796-f5f9-44c3-aeef-67cd051df684",
    "params":{
        "deviceId":"TESTQWERXXXX",
        "channelId":"0",
        "token": "<yourAccessToken>"
    }
}

响应字段

字段名		字段类型	字段说明
channelId		String	通道号
rules	enable	Boolean	动检计划是否生效，true：生效，false：未生效
	beginTime	String	开始时间，时间格式为HH:mm:ss
	endTime	String	结束时间，时间格式为HH:mm:ss
	period	String	重复周期：Monday：每周一，Tuesday：每周二，Wednesday：每周三，Thursday：每周四，Friday：每周五，Saturday：每周六，Sunday：每周日

响应示例

{
    "result":{
        "msg":"操作成功。",
        "code":"0",
        "data":{
            "rules":[
                {
                    "period":"Monday",
                    "enable":true,
                    "beginTime":"00:00:00",
                    "endTime":"01:00:00"
                }
            ],
            "channelId":"0"
        }
    },
    "id":"6a60a796-f5f9-44c3-aeef-67cd051df684"
}

错误码

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

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

说明

子账号 token 须具备最小权限：Permission 为 Config，Resource 为 cam:{deviceId}:{channelId}。配置见权限码。

与 v2 对照（detection.motion.plan，见获取检测时间段属性）：

本页	v2
`rules[]`	`periods[]`（含 `mode`/`polygonMode` 等，v2 独有）
`period` 英文星期名（可逗号合并）	能力表为 `0`–`6`；PaaS 入参仍可按英文星期 + `HH:mm:ss` 理解
`beginTime`/`endTime` `HH:mm:ss`	能力 catalog 常用 `THHmmss`；与 PaaS 策略层格式以设备为准
`rules[].enable`	PaaS 下多为通道计划总开关衍生字段，非逐条可写项；modifyDeviceAlarmPlan 请求无 `enable`