Update Personal Mobile Phone
After the user logs in successfully, call this API when updating the personal mobile phone number.
This is a post-login API. You need to add authorization information in the header: Authorization.
Request Description
Request Headers
| Parameter Name | Name | Required | Type | Example |
|---|---|---|---|---|
| X-operating-sys-version | Caller client operating system version | Yes | String | windows10.1.1 |
| X-device-fingerprint | Caller client device fingerprint | Yes | String | 156aysdna213sc50 |
| X-device-ip | Caller client IP | No | String | 192.168.1.2 |
| X-agent | User-Agent information | Yes | String | Mozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X) |
| X-L | Used for internationalization language setting | No | String | zh |
| X-client-id | Application authorization ID | Yes | String | nTo1eRIub60vPb54WeE6aojPwYwImtl4 |
| Authorization | Authorization information | Yes | String | Bearer {id_token} |
| content-type | Content format type | Yes | String | application/json |
Request Example
json
{
"mobile": "15201657312",
"verify_code": "123456"
}Request Parameters
| Parameter Name | Name | Required | Type | Description |
|---|---|---|---|---|
| mobile | New mobile phone number | Yes | String | New mobile phone number to be updated |
| verify_code | SMS verification code | Yes | String | SMS verification code received by the new mobile phone number For obtaining the verification code, please refer to Send SMS Verification Code API type=UPDATE_MOBILE_SMS |
Response Example
Success Example
HTTP/1.1 200 OK
Error Example
HTTP/1.1 400 Bad Request
json
{
"error_code": "IDAAS.SDK.PARAM.0016",
"error_msg": "IdToken is invalid or expired"
}Response Parameters
None
Error Codes
| Status Code | Error Code | Chinese Error Message | English Error Message | Resolution |
|---|---|---|---|---|
| 400 | IDAAS.SDK.PARAM.0001 | 设备信息不完整 | Device information is incomplete | Please check whether the input device information is complete |
| 400 | IDAAS.SDK.PARAM.0002 | clientId不能为空 | clientId cannot be empty | Please check whether the input clientId is empty |
| 400 | IDAAS.SDK.PARAM.0003 | 应用未注册,请先注册应用 | The app is not registered, please register the app first | Please check whether the input clientId is correct |
| 400 | IDAAS.SDK.PARAM.0015 | IdToken不能为空 | IdToken cannot be empty | Please check whether the input IdToken is empty |
| 400 | IDAAS.SDK.PARAM.0016 | IdToken无效或已过期 | IdToken is invalid or expired | Please re-acquire the IdToken and try again |
| 400 | IDAAS.SDK.PARAM.0009 | 验证码不能为空 | Verification code cannot be empty | Please check whether the input verification code is empty |
| 400 | IDAAS.SDK.CAPTCHA.0007 | 验证码不正确 | Incorrect verification code | Please check whether the input verification code is correct |
| 400 | IDAAS.SDK.USER.0020 | 手机号不符合校验规则 | The phone number does not meet the verification rules | Please check whether the input mobile phone number is correct |
| 400 | IDAAS.SDK.USER.0035 | 手机号已存在 | Phone number already exists | Please change to a mobile phone number that has not been registered |
| 400 | IDAAS.SDK.MOBILE.0002 | 未经认证的手机号 | An unauthenticated cell mobile number | Please check whether the [Enterprise Center - Enterprise Configuration - International Area Code Configuration] meets the configuration rules |
| 400 | IDAAS.SDK.USER.0001 | 用户未找到 | User not found | Please register first and try again |