Skip to content

6 Users

用户功能介绍

当用户访问我的页面时，处于未登录状态。此时点击收藏和历史会自动跳转登录页面，此时需要用户登录。

对于新用户，则需要先进行注册

image-20251025115800563

用户模块主要实现以下功能:

  • 用户注册
  • 用户登录
  • 用户信息获取
  • 用户信息更新
  • 用户密码修改

API接口介绍

1 用户登录

功能描述：用户登录接口

请求方式：POST

接口地址：/api/user/login

请求参数：

参数名 类型 必填 描述
username String 是 用户名
password String 是 密码

响应参数：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
{
  "code": 200,
  "message": "登录成功",
  "data": {
    "token": "用户令牌",
    "userInfo": {
      "id": 1,
      "username": "用户名",
      "nickname": "昵称",
      "avatar": "头像URL"
    }
  }
}

2 用户注册

功能描述：用户注册接口

请求方式：POST

接口地址：/api/user/register

请求参数：

参数名 类型 必填 描述
username String 是 用户名
password String 是 密码

响应参数：

1
2
3
4
5
6
7
8
9
{
  "code": 200,
  "message": "注册成功",
  "token": "用户令牌",
  "data": {
    "id": 1,
    "username": "用户名"
  }
}

3 获取用户信息

功能描述：获取当前登录用户信息

请求方式：GET

接口地址：/api/user/info

请求头：

参数名 类型 必填 描述
Authorization String 是 用户令牌

响应参数：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
  "code": 200,
  "message": "success",
  "data": {
    "id": 1,
    "username": "用户名",
    "nickname": "昵称",
    "avatar": "头像URL",
    "gender": "性别",
    "bio": "个人简介"
  }
}

4 更新用户信息

功能描述：更新用户个人信息

请求方式：PUT

接口地址：/api/user/update

请求头：

参数名 类型 必填 描述
Authorization String 是 用户令牌

请求参数：

参数名 类型 必填 描述
nickname String 否 昵称
avatar String 否 头像URL
gender String 否 性别
bio String 否 个人简介

响应参数：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
  "code": 200,
  "message": "更新成功",
  "data": {
    "id": 1,
    "username": "用户名",
    "nickname": "昵称",
    "avatar": "头像URL",
    "gender": "性别",
    "bio": "个人简介"
  }
}

5 修改密码

功能描述：修改用户密码

请求方式：PUT

接口地址：/api/user/password

请求头：

参数名 类型 必填 描述
Authorization String 是 用户令牌

请求参数：

参数名 类型 必填 描述
oldPassword String 是 当前密码
newPassword String 是 新密码

响应参数：

1
2
3
4
5
{
  "code": 200,
  "message": "密码修改成功",
  "data": null
}