排障：能力不存在、权限不足、取值越界
排障：能力不存在、权限不足、取值越界
本页汇总旧 HTTP 接口备注中的能力集与合法值约束。设备能力路径请先 查询可用能力；失败对照 能力常见问题（如 DV2003 未声明该项、DV2011 权限、DV2004 取值越界、DV2014 缺必填字段）。旧接口无统一错误名，以返回 code 与各接口页为准。
能力不存在
HTTP 旧接口无统一错误文案；设备不具备对应能力集时，以各接口备注与返回 code 为准，能力路径常见 DV2003（见 能力常见问题）。各接口备注中的能力集前提如下。
| 能力前提 | 出处 |
|---|---|
| 云台相关功能需要设备拥有 PT 或 PTZ 云台能力集 | 设备操作说明，以及云台移动、定位、获取位置三页 |
| 需要设备存在 CollectionPoint 收藏点位能力集 | 设备收藏点配置说明 及收藏点各接口 |
| 需要设备支持 TimedCruise 定时巡航能力集 | 设备巡航配置说明、getCruiseConfig |
| 只支持具有 TimedCruise 能力的单通道 IPC 设备；开启巡航需要 regularCruise 使能开关为开 | setCruiseConfig：设置定时巡航 |
| 配置设备画面翻转需要设备拥有 FrameReverse 能力集 | 设备视频画面配置说明 与翻转两页 |
| 配置设备水印需要设备拥有 OSD 能力集 | 同上说明页，以及 OSD 设置、获取页 |
| 电动变焦需要设备拥有 ZoomFocus 能力集 | 同上说明页，以及变焦两页 |
| 夜视模式需要设备拥有 NVM 能力集 | 说明页第 4 条；夜视模式设置、获取页只写这一条 |
| 夜视模式需要设备拥有 LEDS 能力集 | 说明页第 5 条。补光灯设置、查询页的备注是同一句，接口本身是补光灯灵敏度 |
| 需要设备具备 LocalRecord 能力集才支持设备本地录像配置 | 设备录像配置说明。查询计划页把「配置」写成「查询」 |
| 配置设备异常检测音需要 AbAlarmSound 与 CheckAbDecible；配置设备提示音需要 PlaySoundModify | 设备音量配置说明 |
| 需要设备拥有前端智能功能 | 设备智能配置说明 |
| 热度分析需要设备拥有 HeatMap 热度分析能力 | 热度分析设置、获取、热度图数据三页 |
| 使能开关仅支持设备详细信息中 accessType=PaaS 的设备 | setDeviceCameraStatus、getDeviceCameraStatus |
| 动检开关：accessType=PaaS 的设备推荐改用 setDeviceCameraStatus | modifyDeviceAlarmStatus |
| 验证密码、修改密码仅对有 "TCM" 设备能力集的设备有效 | verifyPassword、modifyPassword |
动检、WiFi、重启/校时等是否支持：优先 device.capability.list 或对应 设备能力 属性页。旧 HTTP 动检/WiFi 页未写能力集名时，以设备型号与接口返回为准。
收藏点巡航「否则将不生效」写在 setCruiseConfig：cruisePath 为 custom 时，收藏点 name 必须是 setCollection 里 needCruise 为 true 的收藏点，否则将不生效。这句没有写成错误码。
权限不足
子账号 token 的 Permission / Resource 不满足接口「子账号 token 请求所需最小权限」时，返回权限类错误（能力路径常见 DV2011）。各接口最小权限如下。
"Permission":"Config"，"Resource":"cam:序列号:通道号"：动检、画面、录像计划、录像视频流、巡航、收藏点、音量、夜视、翻转、补光灯、电动变焦、OSD、智能配置、使能开关。"Permission":"Config"，"Resource":"dev:序列号"：WiFi 三个接口、重启、校准 UTC 时间、查询 UTC 时间。"Permission":"Ptz"，"Resource":"cam:序列号:通道号"：云台移动、云台定位、获取云台位置。"Permission":"Format"，"Resource":"dev:序列号"：SD 卡格式化、存储容量、SD 卡状态。"Permission":"Capture"，"Resource":"cam:序列号:通道号"：两条抓图接口。见 抓图与封面。
权限不足时以实际 HTTP 响应 code / msg 为准，勿依赖固定英文字符串。
verifyPassword、modifyPassword 没有「子账号 token 请求所需最小权限」这一节。
setDeviceCameraStatus 的 channelId「是否必填」写否，getDeviceCameraStatus 写是。两页合法值都写：设备级使能无需传递通道号，通道级使能需要传递通道号。这不是权限错误码。
取值越界
参数不在下列合法范围时，接口会拒绝或设备不生效（能力路径常见 DV2004）。已知合法值与限制如下。
- 动检灵敏度
sensitive：[1,5]，1 最低，5 最高。见 setDeviceAlarmSensitivity。读回字段stall的说明相同，见 getDeviceAlarmParam。 - 动检区域：每一行一个 32 位整数；低 22 位对应列，高 10 位固定填 0；整数个数超过行数则丢弃超过个数，不足则默认以 0 填充。见 setDeviceAlarmRegion 与获取动检参数页的备注。
row、column的说明是只读、设备能力。 - 报警计划
period：Monday 至 Sunday，也可写成Monday,Wednesday,Friday这种多选。时间格式 HH:mm:ss。见 modifyDeviceAlarmPlan。 - 画面方向
direction：normal 正常，reverse 翻转。见 modifyFrameReverseStatus。 - 夜视
mode：先 getNightVisionMode 读modes，仅可设置列表内取值（如 Intelligent、FullColor、Infrared、Off、LowLight、SmartLowLight）。见 setNightVisionMode。 - 云台
operation：0 到 10，含义见 controlMovePTZ。h、v取 [-1,1]，z取 [0,1]。见 controlLocationPTZ。 - 定时巡航：
period只可设置一天；beginTime、endTime格式 THHMMSS；custom 路径下收藏点不在巡航计划中则不生效。见 setCruiseConfig。 - 使能
enable：true 开启，false 关闭。enableType合法取值见 setDeviceCameraStatus 参数表。
WiFi ssid/密码、重启与校时的 deviceId 须为设备真实标识与合法字符串；校时接口无时间入参字段，无需传「时间越界」类参数。
其他说明过的设备响应
recoverSDCard：设备SD卡格式化 的 result 不是上面三个错误名：start-recover 开始初始化（正常情况下）；no-sdcard 插槽内无 SD 卡；in-recover 正在初始化（有可能别的客户端已经请求初始化）；sdcard-error 其他 SD 卡错误。