IDaaS Open Platform
Employee Identity (EIAM)

Personal Password Change API

API

After a user successfully logs in, call this API after calling the [Check Personal Password Setting API]. If a password has already been set, the old password must be included in the parameters. If no password has been set, only the new password needs to be passed.

# Request Specifications

Request URL https://{your_domain}/api/v2/sdk/pwd/change

Request Method POST

Content-Type application/json

# Request Header Parameters

Parameter Name Chinese Name Required Type Example
X-operating-sys-version Caller Operating System 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
Authorization ID token returned by the user login API. Format is Bearer {id_token} Yes String Bearer eyJraWQiOiI1ZWZhN2ZmZDA2Z...

# Request Body Example

{
    "old_password": "P@ssw0rd",
    "new_password": "P@ssw0rd123"
}
1
2
3
4

# Request Parameters

Parameter Name Chinese Name Required Type Description
old_password Old Password Yes String The user's old password
new_password New 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

Change Personal Password by Mobile