Skip to content

重置密码

用于重新设置用户密码。重置密码时,在接受到重置密码的短信验证码后,调用此API重新设置用户密码。

调用说明

请求方式:POST
请求url:/api/me/resetPassword
请求参数示例:

json
{
    "userId": "zhangsan",
    "phone": "13112345678",
    "code": "123646",
    "newPassword": "MjM0NTY3OA==",
    "userDirectory": "sys"
}

参数说明:

参数必须说明
phone手机号;如果不传递,则尝试使用当前登录用户的手机号,并且忽略掉userIduserDirectory两个参数;如果不传递又没有登录,则系统会抛出异常
newPassword新密码的base64编码字符串
userId用户ID;用于查找用户,如不传,则表明使用手机号来查找用户
code短信验证码;如果调用了验证重置密码的短信验证码完成验证码校验后,可以不传这个参数
userDirectory用户类型;sys代表系统用户,external代表外部用户,默认为sys

返回值说明

示例:

json
{
    "result": false,
    "errorCode": "phoneNotFound",
    "message": "没有传递 `phone` 参数"
}

参数说明:

参数说明
result校验结果,true标识成功
errorCode错误编码
message错误文本提示

errorCode说明

errorCode说明
phoneResetDisabled系统设置不允许使用手机验证码重置密码
serviceNotFound系统没有开启使用发送验证码的服务
userNotFound用户不存在
userPhoneNotMatch用户ID和手机号不匹配,不能修改密码
passwordInvalid密码不符合密码设置要求
passwordUsed密码为最近使用过的密码
codeNotFound系统没有向手机号发送验证码
codeMismatch验证码错误
lockWarning验证码错误,距离被锁定还剩余一定次数
locked验证码错误次数过多,手机号被锁定了,暂时不能使用该手机进行验证
verifyNotfound没有完成身份验证,不允许修改密码
微信公众号微信公众号:山川软件