新接入请使用 推荐入口。本页保留给仍在调用 POST /openapi/verifyPassword 的兼容对接。

verifyPassword：验证设备密码

要点：https://openapi.lechange.cn/openapi/verifyPassword · 见 错误码

验证设备密码。

请求参数

password加密算法详细说明：
password计算值的公式为：Base64(AES256_CBC(sourcePassword，key[]，iv[]))；
加密规则如下：
1、采用CBC分组加密的方式，算法为AES/CBC/PKCS5Padding；
2、sourcePassword为设备的明文密码；
3、key[]为密匙（key）的二进制数组；
4、密钥（key）为：LowerCase(MD5(UpperCase(Base64(KDF(deviceId,MD5(appsecret))))))，KDF算法为PBKDF2WithHmacSHA256，迭代1200次，导出密钥长度 256；
5、iv[]为初始化向量的二进制数组，为：MD5(appSecret)，采用Java自带的MessageDigest的MD5算法加密。
​
设备新密码规则要求为：
1、密码组成必须包含数字、大写字母、小写字母和特殊字符中的至少两种，长度为8~32字符长度。其中特殊字符为除了【'】【"】【;】【:】【&】【空格】这六个字符外的任意可见字符；
2、密码不能有中文字符。

passwordV2 加密（V2）

v2 能力 device.password.verify 的 passwordV2 算法如下（本遗留路径若扩展 V2 字段时同此规则）：

设备密码字段加密（v2 OpenAPI）

适用字段：device.password.verify 的 passwordV2；device.password.set 的 oldPasswordV2、newPasswordV2。三者同一套算法（与绑定页 encryptCodeV2 同族，字段名不同）。

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

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

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

请求示例

password 须为按上文算法生成的 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":"TESTQWERXXXX",
        "password":"dGVzdEVuY3J5cHRlZFBhc3N3b3JkUGxhY2Vob2xk"
    }
}

响应字段

无data数据返回

响应示例

{
    "result":{
        "msg":"操作成功。",
        "code":"0"
    },
    "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af"
}

错误码

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

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

子账号（SUB）

更多见 错误码 · SUB。

设备访问与通道（DV10xx）

设备密码（DV10xx）

说明

本路径为旧版 OpenAPI（/openapi/verifyPassword），仅支持管理员 accessToken；子用户、子账号请用 device.password.verify（passwordV2、子账号 Config 等见该页）。

相关

• device.password.verify
• 设备配置与操作
• 调用约定
• 遗留 · 设备维护