客户身份(CIAM)

修改个人手机号

用户登录成功后,修改个人手机号时调用本接口。

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

# 请求说明

POST https://{your_domain}/api/v2/sdk/profile/update-mobile

# 请求头

参数名 中文名称 必须 类型 示例
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
Authorization 授权信息 String Bearer {id_token}
content-type 内容格式类型 String application/json

# 请求示例

{
    "mobile": "15201657312",
	"verify_code": "123456"
}
1
2
3
4

# 请求参数

参数名 中文名称 必须 类型 描述
mobile 新手机号 String 修改的新手机号
verify_code 短信验证码 String 新手机号接收的短信验证码
获取验证码请参考发送短信验证码接口 type=UPDATE_MOBILE_SMS

# 返回示例

成功示例:
HTTP/1.1 200 OK
Content-Type: application/json


错误示例:
HTTP/1.1 400 Bad Request
{
    "error_code": "IDAAS.SDK.PARAM.0016",
    "error_msg": "IdToken is invalid or expired"
}
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.0015 IdToken cannot be empty 请检查输入的IdToken是否为空
IdToken不能为空
400 IDAAS.SDK.PARAM.0016 IdToken is invalid or expired 请重新获取IdToken后再试
IdToken无效或已过期
400 IDAAS.SDK.PARAM.0009 Verification code cannot be empty 请检查输入的验证码是否为空
验证码不能为空
400 IDAAS.SDK.CAPTCHA.0007 Incorrect verification code 请检查输入的验证码是否正确
验证码不正确
400 IDAAS.SDK.USER.0020 The phone number does not meet the verification rules 请检查输入的手机号是否正确
手机号不符合校验规则
400 IDAAS.SDK.USER.0035 Phone number already exists 请更换未注册过的手机号
手机号已存在
400 IDAAS.SDK.MOBILE.0002 An unauthenticated cell mobile number 请检查输入的手机号是否正确
未经认证的手机号
400 IDAAS.SDK.USER.0001 User not found 请先注册后再试
用户未找到