# 修改用户密码 API
修改用户密码,使用 POST
发起请求,请求地址为 /api/v1/users/actions/resetPassword
。
POST /api/v1/users/actions/resetPassword
# 请求 URI
参数名 | 位置 | 类型 | 必填 | 说明 |
---|---|---|---|---|
apiKey | query | 字符串 | 否 | API 密钥,请参考身份认证 |
# 请求 Body
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
account | 字符串 | 是 | 用户账号,可以是用户名、邮箱或者手机号 |
password | 字符串 | 是 | 用户老密码,需要 MD5 加密后传输 |
newPassword | 字符串 | 是 | 用户新密码,无需 MD5 加密,直接传输密码明文 |
# 返回
名称 | 类型 | 说明 |
---|---|---|
200 OK | User | 用户 |
401 Unauthorized | Error | 认证错误 |
400 BadRequest | Error | 参数错误 |
# 示例
# 请求示例
POST /api/v1/users/actions/resetPassword
Content-Type: application/json
X-SS-API-KEY: 7cd22002-27a7-4c5d-ba4d-a1c108a20eaf
{
"account": "demo",
"password": "7d683abba984a7804078471700c39fb9",
"newPassword": "password888"
}
# 返回示例
{
"id": 1,
"userName": "demo",
"password": "3CPlhZ8UAus=",
"passwordFormat": "Encrypted",
"createDate": "2018-06-17 14:18:45",
"lastResetPasswordDate": "2018-06-17 14:18:45",
"lastActivityDate": "2018-06-17 14:18:45",
"countOfLogin": 0,
"countOfFailedLogin": 0,
"countOfWriting": 0,
"checked": true,
"locked": false,
"displayName": "用户名",
"email": "demo@sample.com",
"mobile": "13888888888",
"avatarUrl": "",
"openId": ""
}