前台登录接口－用户管理模块

上级目录：Java电商平台项目-用户管理模块开发

1. 登录

/user/login.do

post(代码需要post请求)

request

username, password

response

fail

{
    "status": 1,
    "msg": "密码错误"
}

success

{
    "status": 0,
    "msg": "登录成功",
    "data": {
        "id": 1,
        "username": "admin",
        "email": "[email protected]",
        "phone": "13800138000",
        "question": "问题",
        "answer": "答案",
        "role": 1,
        "createTime": "2016-11-06T22:56:45.000+0000",
        "updateTime": "2017-04-05T00:27:36.000+0000"
    }
}

2. 注册

• url : /user/register.do

• requestMethod: post

• requestParams

username,password,email,phone,question,answer

• paramExample：

username:ldy
password:123456
email:[email protected]
phone:18354131190
question:姓名
answer:李登印

• response

• success

{
    "status": 0,
    "msg": "注册成功"
}

• fail

{
    "status": 1,
    "msg": "用户名已存在，重复注册"
}

3. 注册时校验用户名和邮箱是否已经注册

URL: /usr/check_valid.do

• RequestMethod: POST
• RequestParams:

str,type
str代表具体需要校验的数据，type代表校验的类型，一共两种username 和email

• ParamExample:

str:ldy
type:username

• Response
• FAIL

{
    "status": 1,
    "msg": "用户名已存在，重复注册"
}

{
    "status": 1,
    "msg": "邮箱已注册，重复注册"
}

• SUCCESS

{
    "status": 0,
    "msg": "校验成功"
}

4. 获取登录用户信息

• URL: /user/get_user_info.do
• RequestMethod: GET
• RequestParams

无参数

• Response
• FAIL

{
    "status": 1,
    "msg": "用户未登录，无法获取当前用户信息"
}

• SUCCESS

{
    "status": 0,
    "data": {
        "id": 1,
        "username": "admin",
        "email": "[email protected]",
        "phone": "13800138000",
        "question": "问题",
        "answer": "答案",
        "role": 1,
        "createTime": "2016-11-06T22:56:45.000+0000",
        "updateTime": "2017-04-05T00:27:36.000+0000"
    }
}

5. 返回找回密码时设置的问题

URL: /user/forget_get_question.do

• RequestMethod: POST
• RequestParams

username

• Response
• FAIL

{
    "status": 1,
    "msg": "用户不存在"
}

• SUCCESS

{
    "status": 0,
    "msg": "姓名"
}

6. 验证忘记密码时回答问题是否正确，正确时返回guava找回密码验证token

URL: /user/forget_check_answer.do

• RequestMethod: POST
• RequestParam

username, question.answer

• Response
  正确的返回值里面有一个token，修改密码的时候需要用这个。传递给下一个接口
• SUCCESS

{
    "status": 0,
    "msg": "e31a6c30-2ea0-4b2a-88bf-7556fb77c8dc"
}

• FAIL

{
    "status": 1,
    "msg": "问题的答案错误"
}

7. 忘记密码的重置密码功能

URL: /user/forget_rest_password.do

• RequestMethod: POST
• RequestParams

username, passwordNew, token

• Response
• FAIL

{
    "status": 1,
    "msg": "token错误，请重新获取重置密码的token"
}

{
    "status": 1,
    "msg": "用户不存在"
}

{
    "status": 1,
    "msg": "token已经失效"
}

{
    "status": 1,
    "msg": "修改密码操作失效"
}

• SUCCESS

{
    "status": 0,
    "msg": "密码修改成功"
}

8. 登录状态中的重置密码

URL: /usr/reset_password.do

• RequestMethod: POST
• RequestParams:

passwordOld,passwordNew

• Response
• FAIL

{
    "status": 1,
    "msg": "旧密码错误"
}

• SUCCESS

{
    "status": 0,
    "msg": "密码修改成功"
}

9. 登录状态更新个人信息

URL:	/user/update_information.do

• RequestMethod: PSOT
• RequestParam:

email,phone,question,answer

• Response:
• Success

{
    "status": 0,
    "msg": "更新个人信息成功",
    "data": {
        "id": 22,
        "email": "[email protected]",
        "question": "学校",
        "answer": "广东海洋大学"
    }
}

• Fail

{
    "status": 1,
    "msg": "用户未登录"
}

10. 获取当前登录用户的详细信息，并且强制登录（跳转登录页面）

URL: /user/get_information.do

• RequestMethod: GET
• RequestParams

无参数

• Response
• SUCCESS

{
    "status": 0,
    "data": {
        "id": 22,
        "username": "ldy",
        "email": "[email protected]",
        "phone": "18354131190",
        "question": "学校",
        "answer": "广东海洋大学",
        "role": 0,
        "createTime": "2020-05-01T23:41:34.000+0000",
        "updateTime": "2020-05-02T00:55:26.000+0000"
    }
}

• FAIL

{
    "status": 10,
    "msg": "用户未登录,无法获取当前用户信息,status=10,强制登录"
}

11. 退出登录

URL: /user/logout.do

• ResquestMethod: GET
• RequestParams:

无参数

• Response
• SUCCESS

{
    "status": 0
}

• FAIL

{
    "status": 1,
    "msg": "服务端异常"
}