Employee Identity (EIAM)

Password Recovery via Mobile Number Interface

Interface

When a user clicks "Forgot Password" on the login page and chooses to recover via mobile number, they need to enter their mobile number, verification code, and new password, pass the CAPTCHA verification, and then call this interface. After a successful call, the user needs to return to the login page to log in again.

# Request Specification

Request URL https://{your_domain}/api/v2/sdk/pwd/update-by-mobile

Request Method POST

Content-Type application/json

# Request Header Parameters

Parameter Chinese Name Required Type Example
X-operating-sys-version Caller OS Version Yes String windows10.1.1
X-device-fingerprint Caller Device Fingerprint Yes String 156aysdna213sc50
X-device-ip Caller 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) AppleWebKit/605.1.15(KHTML, like Gecko)
Mobile/15E148/HuaWei-AnyOffice/2.6.1802.0010/com.huawei.cloudlink.workplace
X-L For internationalization language setting No String zh
X-client-id Application Authorization ID Yes String nTo1eRIub60vPb54WeE6aojPwYwImtl4

# Request Body Example

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

# Request Parameters

Parameter Chinese Name Required Type Description
mobile Mobile Number Yes String The mobile number receiving the verification code
verify_code SMS Verification Code Yes String The received verification code
To get a verification code, please refer to the Send SMS Verification Code Interface
type = CHANGE_PWD_SMS
password Password Yes String The new password to be set

# Return Example

Success Example:
HTTP/1.1 200 OK
Content-Type: application/json
Error Example:
HTTP/1.1 400 Bad Request
{
    "error_code": "SDK.COMMON.1001",
    "error_msg": "Parameter X-client-id cannot be left blank."
}
1
2
3
4
5
6
7
8
9

# Return Parameters

None