修改密码

适用场景

当您需要更换OpenAPI当前登录密码时，调用修改密码接口。该接口为同步接口，不需要先登录，也不需要在 Header 中携带 token。

每次修改都需要提交当前生效的密码；修改成功后，您可以在后续需要时再次调用同一接口。

调用流程

准备账户名、当前密码和符合规则的新密码。
调用修改密码接口；请求成功时，密码立即更新。
此时旧密码相关token会失效,MQTT客户端也会断开，需要使用新密码重新建立连接。

请求示例

curl -L -X POST 'https://lb.solinteg-cloud.com/openapi/v2/loginv2/resetPassword' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "authAccount": "YOUR_ACCOUNT",
    "currentPassword": "CURRENT_PASSWORD",
    "newPassword": "NEW_PASSWORD"
  }'

提示

新密码规则

长度为 6 至 18 位。
在大写字母、小写字母、数字、特殊字符四类中，至少包含三类。
特殊字符仅允许 ~!@#$%^&*?+=,-.；不允许空格、中文和其他特殊字符。
不得与当前密码相同。

响应与处理

成功时，接口返回：

{
  "errorCode": 0,
  "info": null,
  "body": null,
  "successful": true
}

失败时，接口返回对应错误码和错误说明，例如：

账户名或当前密码错误

{
  "errorCode": 1,
  "info": {
    "code": "error.45001",
    "description": "Account or current password is invalid"
  },
  "body": null,
  "successful": false
}

账户不存在和当前密码错误均返回 error.45001，不会区分具体原因。

新密码不符合规则

{
  "errorCode": 1,
  "info": {
    "code": "error.45002",
    "description": "New password does not meet the password policy"
  },
  "body": null,
  "successful": false
}

请求过于频繁

{
  "errorCode": 1,
  "info": {
    "code": "error.45005",
    "description": "Too many password reset attempts. Please try again after 24 hours."
  },
  "body": null,
  "successful": false
}

同一账户在 24 小时内最多可提交 10 次修改密码请求；无论请求成功或失败都会计入。第 11 次及后续请求返回 error.45005。

安全建议

仅通过 HTTPS 调用接口，避免在浏览器、App 前端或日志中暴露账户密码。

适用场景​

调用流程​

请求示例​

响应与处理​

账户名或当前密码错误​

新密码不符合规则​

请求过于频繁​

安全建议​