本页目录
请求参数
密码字段加密
请求示例
响应字段
响应示例
错误码
说明
相关

device.password.verify（验密）

device.password.verify：验密

要点：https://openapi.lechange.cn/openapi/v2/device.password.verify · 见 错误码

入参 passwordV2（加密）。本方法不会出现在 device.capability.list 里。通过时 data 为 {}。改密 oldPasswordV2 与 passwordV2 同规则，验密密文可复用作原密码。

请求参数

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

密码字段加密

设备密码字段加密（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、同一明文）。

请求示例

下列 passwordV2 为 Base64 占位，须按「密码字段加密」生成，非明文。

{
  "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": "dGVzdFYyR2NtUGxhY2Vob2xkTm9uUGxhaW4="
  }
}

响应字段

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

响应示例

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

错误码

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

网关与鉴权（SN / TK / OP）

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

验密（DV10 / DV20）

错误码错误码说明下一步
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 字段

说明

管理员：绑定不需要权限码；被分享设备需要 Config 或 config（填其中一个即可）。子用户：绑定不需要权限码。子账号：Config。资源写法见 权限码。与旧版 verifyPassword 不同：本 v2 接口允许子用户/子账号；旧路径仅管理员。

相关

device.password.set（改密）
device.property.get（批量读配置）