客户身份(CIAM)
通过邮箱忘记密码
用户在登录页面点击忘记密码，并选择通过邮箱找回密码时，需要输入邮箱和验证码还有新的密码并通过图形验证码校验后调用本接口。调用成功后需要返回登录页面重新登录。
# 请求说明
POST https://{your_domain}/api/v2/sdk/pwd/update-by-email
# 请求头
| 参数名 | 中文名称 | 必须 | 类型 | 示例 |
|---|---|---|---|---|
| X-operating-sys-version | 调用方操作系统版本 | 是 | String | windows10.1.1 |
| X-device-fingerprint | 调用方设备指纹 | 是 | String | 156aysdna213sc50 |
| X-device-ip | 调用方IP | 否 | String | 192.168.1.2 |
| X-agent | User-Agent信息 | 是 | String | Mozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X) |
| X-L | 用于国际化语言设置 | 否 | String | zh |
| X-client-id | 应用授权ID | 是 | String | nTo1eRIub60vPb54WeE6aojPwYwImtl4 |
| content-type | 内容格式类型 | 是 | String | application/json |
# 请求示例
{
"email": "15200000000@qq.com",
"verify_code": "123456",
"password": "P@sdsdfsdfds"
}
1
2
3
4
5
2
3
4
5
# 请求参数
| 参数名 | 中文名称 | 必须 | 类型 | 描述 |
|---|---|---|---|---|
| 邮箱 | 是 | String | 邮箱 | |
| verify_code | 短信验证码 | 是 | String | 邮箱验证码 获取验证码请参考发送邮箱验证码接口 type=FORGET_PWD_EMS |
| password | 新密码 | 是 | String | 设置的新密码 |
# 返回示例
成功示例:
HTTP/1.1 200 OK
Content-Type: application/json
错误示例:
HTTP/1.1 400 Bad Request
{
"error_code": "IDAAS.SDK.CAPTCHA.0007",
"error_msg": "Incorrect verification code"
}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
# 返回参数
无
# 错误码
| 状态码 | 错误码 | 错误信息 | 处理措施 |
|---|---|---|---|
| 400 | IDAAS.SDK.PARAM.0001 | Device information is incomplete | 请检查输入的设备信息是否完整 |
| 设备信息不完整 | |||
| 400 | IDAAS.SDK.PARAM.0002 | clientId cannot be empty | 请检查输入的clientId是否为空 |
| clientId不能为空 | |||
| 400 | IDAAS.SDK.PARAM.0003 | The app is not registered, please register the app first | 请检查输入的clientId是否正确 |
| 应用未注册，请先注册应用 | |||
| 400 | IDAAS.SDK.PARAM.0009 | Verification code cannot be empty | 请检查输入的验证码是否为空 |
| 验证码不能为空 | |||
| 400 | IDAAS.SDK.CAPTCHA.0007 | Incorrect verification code | 请检查输入的验证码是否正确 |
| 验证码不正确 | |||
| 400 | IDAAS.SDK.USER.0005 | E-mail cannot be empty | 请检查入参中的邮箱字段是否为空 |
| 邮箱不能为空 | |||
| 400 | IDAAS.SDK.USER.0006 | Password cannot be empty | 请检查输入的密码是否为空 |
| 密码不能为空 | |||
| 400 | IDAAS.SDK.USER.0001 | User not found | 请先注册后再试 |
| 用户未找到 | |||
| 400 | IDAAS.SDK.PWD.0001 | The password is used before, cannot be used again | 请重新输入密码 |
| 不允许使用历史密码 | |||
| 400 | IDAAS.SDK.PWD.0002 | Password cannot username in reverse order | 请重新输入密码 |
| 密码不允许使用用户名的倒写 | |||
| 400 | IDAAS.SDK.PWD.0003 | Password cannot contain :username, phone number, email prefix, name in PinYing | 请重新输入密码 |
| 密码中不允许包含：用户名、手机号、邮箱前缀、姓名拼音 | |||
| 400 | IDAAS.SDK.PWD.0004 | Your password complexity is low, {0} | 请重新输入密码 |
| 密码复杂度低，{0} | |||
| 400 | IDAAS.SDK.PWD.0005 | The password is weak | 请重新输入密码 |
| 该密码为弱密码 | |||
| 400 | IDAAS.SDK.PWD.0006 | Number of character repeat in password should not exceed {0} | 请重新输入密码 |
| 密码中最大字符重复数不能超过{0} | |||
| 400 | IDAAS.SDK.PWD.0007 | The password must contain {0} to {1} characters | 请重新输入密码 |
| 密码长度为{0}~{1}个字符 |