乐橙云开发文档
控制台
更新日志
控制台
更新日志
快速入门
  • 开始使用
  • 核心概念
  • 开发指南
  • 设备能力与事件参考
    • 按设备类型浏览
    • 设备能力
      • 通用方法
      • 侦测与告警
      • 图像
      • 云台
      • 灯光
      • 录像
      • 音频
      • 媒体
      • 网络
      • 电源
      • 隐私
      • 呼叫
      • 存储
      • 系统
      • 算法
      • 设备维护
        • 重启设备
        • 恢复出厂
        • 平台校时
        • 获取 UTC 时钟
        • 当前 WiFi
        • 扫描热点
        • 连接或断开 WiFi
        • 升级进度
        • 触发升级
        • 改名
        • 刷新封面
        • 验密
        • 改密
      • 控制
      • 接口清单
      • 先跑通一次
    • 事件目录
    • 权限码
    • 错误码
    • 告警消息
  • API 参考
  • SDK 与工具
  • 行业方案
  • 平台与支持
本页目录
功能详情
请求地址
最小权限
传入参数说明
密码字段加密
样例输入
返回 data 字段说明
样例输出
错误码

验密

验密

功能详情

入参 passwordV2(deviceId 上下文 AES 密文,非明文)。本方法不会出现在 device.capability.list 里。通过时 data 为 {}。与改密 oldPasswordV2 / newPasswordV2 同规则。改密见 改密。

请求地址

POST https://openapi.lechange.cn/openapi/v2/device.password.verify

最小权限

管理员操作自己绑定的设备不需要权限。操作被分享设备需要基础配置权限。子用户绑定不需要。子账号需要 Config。见 权限码。

传入参数说明

参数名参数类型是否必填默认值合法值参数说明
tokenString是管理员、子用户或子账号 accessToken
deviceIdString是设备序列号
productIdString否可省略。传了且与该设备实际型号不一致 → DV2009
passwordV2String是设备密码 v2 密文(见下文「密码字段加密」)

公共请求字段与签名见 签名约定 与 公共请求负载。

密码字段加密

设备密码字段加密(v2 OpenAPI)

适用字段:device.password.verify 的 passwordV2;device.password.set 的 oldPasswordV2、newPasswordV2。三者同一套算法(与绑定页 encryptCodeV2 同族,字段名不同)。

步骤说明
1. 明文设备密码 UTF-8 字符串(newPasswordV2 须先满足下文强度规则再加密)
2. 因子pwdFactor = "op_api_" + appId + "_PWD_KEY_" + deviceId(appId 取请求 system.appId,须与派生时一致)
3. Saltsalt = SHA-256(UTF-8(pwdFactor)) 的前 16 字节
4. PBKDF2PBKDF2WithHmacSHA256:password=deviceId,salt=上一步,迭代 1200 次,导出 256 位 → kdfRaw
5. AES 密钥kdfBase64 = Base64(kdfRaw)(标准 Base64);aesKey = SHA-256(UTF-8(kdfBase64.toUpperCase())) → 32 字节 AES-256 密钥
6. Nonce加密时随机 12 字节(每次加密不同)
7. 加密AES/GCM/NoPadding,GCM tag 128 bit;密文块 = AES-GCM(明文)(含 tag)
8. 传参值Base64(nonce[12] ‖ 密文块),作为对应字段字符串

不使用 appSecret 参与 v2 密钥派生。

新密码明文(仅 newPasswordV2 加密前):长度 8~32;数字、大写字母、小写字母、特殊字符中至少两类;特殊字符为除 '、"、;、:、&、空格外的可见字符;不得含中文。

验密成功后改密:可将本次请求的 passwordV2 整段密文原样填入 oldPasswordV2(同一 appId、deviceId、同一明文)。

样例输入

{
  "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>",
    "deviceId": "TESTIPC000012345",
    "passwordV2": "encrypted-password"
  }
}

返回 data 字段说明

无业务字段。成功时 code 为 "0",data 为 {}。

样例输出

{
  "id": "d5c287b4-5b2f-4f03-baf5-8032c5c354af",
  "result": {
    "code": "0",
    "msg": "Operation is successful",
    "data": {}
  }
}

错误码

本接口可能返回下列码。

网关

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

DV20xx

错误码错误码说明下一步
DV1016密码错误核对密码

DV21xx

错误码错误码说明下一步
DV2101SDK 未就绪,需重新初始化稍后重试
DV2102设备侧网络断开检查设备网络
DV2103设备未连接平台,请求或事件无法送达等设备上线
DV2104设备侧超时可重试查询类;写操作不要盲目重试
DV2105设备侧内存或资源不足稍后重试
DV2106设备侧报文或协议格式错误核对入参结构
DV2107设备注册或登录失败检查设备状态
DV2108设备鉴权失败核对设备密码 / 安全码
DV2109用户名或密码错误核对密码
DV2110设备因认证失败次数过多已锁定等待解锁
DV2111请求签名、时间戳或防重放校验失败核对签名与时间
DV2112WiFi 参数错误核对 ssid / 密码
DV2113设备身份不匹配(型号 / 序列号)核对序列号与型号
DV2114物联网卡号非法核对卡号
DV2115请求方法或 URL 非法核对路径
DV2116设备不支持该能力或该请求对照 list
DV2117设备侧属性、服务、事件或资源不存在对照 list
DV2118设备侧参数或属性值非法按取值修改
DV2119设备侧未设置处理回调,无法响应稍后重试或换接口
DV2120设备侧属性只读不要写
DV2121已达数量或配置上限先删再建
DV2122目标已存在改名或跳过
DV2123不满足当前操作条件见 msg;休眠设备先唤醒
DV2124对讲忙或呼叫已挂断稍后重试
DV2125低电量拒绝操作充电后再试
DV2126升级失败查 device.upgrade.process
DV2127设备内部错误稍后重试
DV2128设备未初始化完成初始化
DV2129设备已初始化或初始化失败见 msg
DV2130子设备操作失败核对子设备
DV2131子设备不存在核对子设备序列号
DV2132存储介质异常检查 SD / 硬盘
DV2133名称冲突改名
DV2134设备侧权限不足核对权限
DV2199未收录的设备侧错误读响应体 msg 字段

商务合作:cloud_openteam@imou.com · 工单 · 获取帮助(公众号、小程序试用中心)

Copyright © 2015-2026 IMOU. All Rights Reserved. 浙ICP备16023676号

刷新封面
改密