1. 重置密码
重置密码。
请求方式:POST
请求地址:/bospersonnelservice/{appKey}/users/resetPassword
1.1. 请求参数:
Headers:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
PathParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
appKey | string | w8486e2a067e4bdab7630546ad01751a | 是 | 应用的 key |
SearchParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
1.2. 请求主体:
Body(form-data)
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
idenType | string | telephone/email | 是 | 识别码类型 |
identifier | string | NULL | 是 | 识别码 |
newPassword | string | az**241 | 是 | 新密码 |
validateCode | string | 1234 | 是 | 手机验证码 |
1.3. 正确返回:
{
"message": "请求处理成功",
"code": "SUCCESS",
"data": null
}
1.4. 状态码:
状态码 | code | message | data | 原因 |
---|---|---|---|---|
400 | USER_NO_EXIST | 用户不存在 | NULL | 如果用户无法找到 |
400 | CAPTCHA_EXPIRED_ERROR | 验证码已过期,请重新获取验证码 | NULL | 如果验证信息不存在或者验证信息已经过期 |
400 | PARAMETER_VALID_ERROR | xxx不能为空 | NULL | 如果idenType 、identifier 、newPassword为空 |
400 | PARAMETER_VALID_ERROR | xxx不能为空 | NULL | 如果idenType为secretAnswer或者为内网,但secretAnswer为空 |
400 | PARAMETER_VALID_ERROR | xxx不能为空 | NULL | 如果idenType为telphone或者email并且为外网,但是validateCode为空 |
400 | SECRETANSWER_ERROR | 答案错误 | NULL | 如果idenType为secretAnswer或者为内网但安全问答不正确 |
400 | CAPTCHA_INPUT_ERROR | 验证码错误,请重新输入 | NULL | 如果是外网并且idenType为telphone或者email,进行验证码校验,验证码校验不通过 |
400 | PASSWORDS_ARE_THE_SAME | 新旧密码相同 | NULL | 如果新旧密码一致 |
1.5. 注意事项:
1、idenType、identifier、newPassword都是必填。
2、如果是内网,secretAnswer为必填。
3、通过识别码类型和识别码 查询账号,如果用户无法找到就报错。
4、如果是BOS用户,调用centerService的重置密码接口校验。
5、如果识别码为secretAnswer,进行安全应答验证。
6、此接口需要调用到发送手机验证码接口
1.6. 请求示例
请求URL
http://bosgw.bimwinner.com/bospersonnelservice/w8486e2a067e4bdab7630546ad01751a/users/resetPassword
Headers
null
Body(form-data)
{
"idenType":"telephone",
"identifier":"13420119014",
"newPassword":"1234567890",
"validateCode":"5469"
}
正常响应 200
{
"message": "请求处理成功",
"code": "SUCCESS",
"data": null
}