密码过期强制修改密码接口
调用用户名密码登录接口时,如果密码已过期或者密码快过期,并且用户选择修改密码时调用本接口。
请求说明
请求头
| 参数名 | 中文名称 | 必须 | 类型 | 描述 |
|---|---|---|---|---|
| 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) AppleWebKit/605.1.15(KHTML, like Gecko) Mobile/15E148/HuaWei-AnyOffice/2.6.1802.0010/com.huawei.cloudlink.workplace |
| X-L | 用于国际化语言设置 | 否 | String | zh |
| X-client-id | 应用授权ID | 是 | String | nTo1eRIub60vPb54WeE6aojPwYwImtl4 |
| X-state-token | 临时令牌 | 是 | String | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWJqZW1... |
请求示例
json
{
"old_password": "P@ssw0rd",
"new_password": "P@ssw0rd123"
}请求参数
| 参数名 | 中文名称 | 必须 | 类型 | 描述 |
|---|---|---|---|---|
| old_password | 原密码 | 是 | String | 用户的老密码 |
| new_password | 新密码 | 是 | String | 设置的新密码 |
返回示例
错误示例
HTTP/1.1 400 Bad Request
json
{
"error_code": "SDK.COMMON.1001",
"error_msg": "Parameter X-client-id cannot be left blank."
}返回参数
| 参数名 | 中文名称 | 类型 | 描述 |
|---|---|---|---|
| status | 返回结果 | String | 该字段可能返回的值如下 |
| expire | session_token有效期 | Number | session_token有效期,有效期内可使用session_token获取ticket |
| session_token | 用户session_token | String | 用户session_token,可使用该token调用IDaaS接口获取sso_ticket,sso_ticket可以换取用户信息 |
| state_token | 用户带有状态的令牌 | String | 用户带有状态的令牌 |
| data | 返回说明 | String | 返回说明 |
| id_token | 短期有效,接口调用凭证 | String | 该字段是一个jwt,保存了用户信息以及应用的scope信息需要验签后获取,默认2小时有效,支持可配置 |