title: 个人博客 v1.0.0
language_tabs:

• shell: Shell
• http: HTTP
• javascript: JavaScript
• ruby: Ruby
• python: Python
• php: PHP
• java: Java
• go: Go
  toc_footers: []

includes: []
search: true
highlight_theme: darkula
headingLevel: 2

个人博客

v1.0.0

Default

POST 登录

POST /api/login

Body 请求参数

type: object
properties:
  username:
    type: string
    description: 用户名
    example: admin
  password:
    type: string
    description: 密码
    example: "1314521999"
required:
  - username
  - password

请求参数

返回示例

成功

{
  "status": 0,
  "message": "登陆成功！",
  "userInfo": {
    "user_id": 15,
    "username": "admin",
    "password": "",
    "nickname": "辰漪",
    "user_pic": "https://wrz521.top:8080/uploads/art_cover-2021-09-13 16-56-36.png",
    "is_admin": 1,
    "is_use": 1,
    "reg_time": "2021-08-26T08:08:08.000Z"
  },
  "token": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoxNSwidXNlcm5hbWUiOiJhZG1pbiIsInBhc3N3b3JkIjoiIiwibmlja25hbWUiOiLovrDmvKoiLCJ1c2VyX3BpYyI6Imh0dHBzOi8vd3J6NTIxLnRvcDo4MDgwL3VwbG9hZHMvYXJ0X2NvdmVyLTIwMjEtMDktMTMgMTYtNTYtMzYucG5nIiwiaXNfYWRtaW4iOjEsImlzX3VzZSI6MSwicmVnX3RpbWUiOiIyMDIxLTA4LTI2VDA4OjA4OjA4LjAwMFoiLCJpYXQiOjE2NDAxNDk4MjcsImV4cCI6MTY0MDE4NTgyN30.bXcGc-iMvVhICfF64EWpBZcQxETbkCFqWORnRgiCnCg"
}

返回结果

返回数据结构

状态码 200

blog

GET 获取用户信息列表分页

GET /my/getUserListPage

请求参数

返回示例

成功

{
  "status": 0,
  "msg": "获取用户列表成功！",
  "total": 6,
  "data": [
    {
      "user_id": 44,
      "username": "admin3",
      "nickname": "辰漪3",
      "user_pic": "3",
      "is_admin": 0,
      "is_use": 1,
      "reg_time": "2022-01-13T05:44:04.000Z"
    },
    {
      "user_id": 43,
      "username": "admin2",
      "nickname": "辰漪1",
      "user_pic": "1",
      "is_admin": 0,
      "is_use": 1,
      "reg_time": "2022-01-12T06:22:14.000Z"
    },
    {
      "user_id": 39,
      "username": "admin11561",
      "nickname": null,
      "user_pic": null,
      "is_admin": 0,
      "is_use": 1,
      "reg_time": "2022-01-11T07:25:21.000Z"
    },
    {
      "user_id": 30,
      "username": "admin1",
      "nickname": null,
      "user_pic": null,
      "is_admin": 0,
      "is_use": 1,
      "reg_time": "2022-01-11T06:44:05.000Z"
    },
    {
      "user_id": 26,
      "username": "admin",
      "nickname": null,
      "user_pic": null,
      "is_admin": 0,
      "is_use": 1,
      "reg_time": "2022-01-11T06:35:04.000Z"
    },
    {
      "user_id": 16,
      "username": "123",
      "nickname": null,
      "user_pic": null,
      "is_admin": 0,
      "is_use": 1,
      "reg_time": "2022-01-11T06:06:24.000Z"
    }
  ]
}

返回结果

返回数据结构

状态码 200

POST 用户注册

POST /api/reguser

Body 请求参数

type: object
properties:
  username:
    type: string
    description: 用户名
  password:
    type: string
    description: 密码
required:
  - username
  - password

请求参数

返回示例

成功

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

返回结果

返回数据结构

状态码 200

POST 文件上传

POST /my/uploads

Body 请求参数

type: object
properties:
  avatar:
    type: string
    description: 要上传的文件信息
    format: binary

请求参数

返回示例

成功

{
  "status": 0,
  "fileInfo": {
    "fieldname": "avatar",
    "originalname": "g.png",
    "encoding": "7bit",
    "mimetype": "image/png",
    "destination": "./uploads",
    "filename": "avatar-2022-01-20 14-43-33.png",
    "path": "/uploads/avatar-2022-01-20 14-43-33.png",
    "size": 19531
  },
  "msg": "上传成功！"
}

返回结果

返回数据结构

状态码 200

PUT 更新用户基本资料

PUT /my/updateInfo

Body 请求参数

type: object
properties:
  nickname:
    type: string
    description: 昵称
  user_pic:
    type: string
    description: 头像
  is_admin:
    type: string
    description: 是否管理员
  is_use:
    type: string
    description: 账号是否可用

请求参数

返回示例

成功

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

返回结果

返回数据结构

状态码 200

PUT 修改密码

PUT /my/updatePwd

Body 请求参数

type: object
properties:
  currentPwd:
    type: string
    description: 当前密码
  editPwd:
    type: string
    description: 要修改的密码
  repeatPwd:
    type: string
    description: 重复密码
required:
  - currentPwd
  - editPwd
  - repeatPwd

请求参数

返回示例

返回结果

返回数据结构

状态码 200

数据模型