客户身份(CIAM)

通过邮箱修改个人密码

修改个人密码方式包含三种:
通过手机号修改密码
通过旧密码修改密码
通过邮箱修改密码

本文主要讲述通过邮箱修改个人密码。

此接口为登录后的接口,需要在header中添加鉴权信息:Authorization。

# 请求说明

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
Authorization 授权信息 String Bearer {id_token}

# 请求示例

{
    "verify_code": "123456",
    "password": "P@sdsdfsdfds"
}
1
2
3
4

# 请求参数

参数名 中文名称 必须 类型 描述
verify_code 短信验证码 String 邮箱验证码
获取验证码请参考发送邮箱验证码接口 type=UPDATE_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

# 返回参数

# 错误码

状态码 错误码 错误信息 处理措施
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}个字符