cf_Ghbf

Appearance

人员管理（管理员账号） ​

管理员账号（sys_user）的维护，对应管理端「人员管理」页面，与会员（sys_member）相互独立。

用户分页列表 ​

接口地址 ​

text
GET /admin/user/list

接口参数说明 ​

Query 参数类型必填说明
keywordstring否搜索关键字（账号/昵称/手机号）
statusinteger否状态 1启用 2禁用
dept_idinteger否部门ID
pageinteger否页码，默认 1
page_sizeinteger否每页数量，默认 20，最大 100

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": 1,
        "created_at": "2026-09-25T10:00:00+08:00",
        "updated_at": "2026-09-25T10:00:00+08:00",
        "username": "admin",
        "nickname": "超级管理员",
        "avatar": "/files/2026/09/23/8f14e45fceea167a5a36dedd4bea2543.png",
        "mobile": "",
        "email": "",
        "dept_id": 0,
        "status": 1,
        "is_super": 0,
        "roles": [
          {
            "id": 1,
            "created_at": "2026-09-25T10:00:00+08:00",
            "updated_at": "2026-09-25T10:00:00+08:00",
            "name": "运营专员",
            "code": "operator",
            "parent_id": 0,
            "sort": 0,
            "status": 1,
            "remark": ""
          }
        ]
      }
    ],
    "total": 12
  }
}

响应参数说明 ​

响应字段类型说明
listarray<UserItem>
list[].idinteger主键ID
list[].created_atstring创建时间
list[].updated_atstring更新时间
list[].usernamestring登录账号
list[].nicknamestring用户昵称
list[].avatarstring头像访问地址（按当前默认存储动态生成）
list[].mobilestring手机号
list[].emailstring邮箱
list[].dept_idinteger部门ID
list[].statusinteger状态 1启用 2禁用
list[].is_superinteger是否超级管理员 0否 1是
list[].rolesarray<RoleItem>角色列表
list[].roles[].idinteger主键ID
list[].roles[].created_atstring创建时间
list[].roles[].updated_atstring更新时间
list[].roles[].namestring角色名称
list[].roles[].codestring角色编码（唯一）
list[].roles[].parent_idinteger上级角色ID，0 为顶级
list[].roles[].sortinteger排序
list[].roles[].statusinteger状态 1启用 2禁用
list[].roles[].remarkstring备注
totalinteger数据总数

新增用户 ​

接口地址 ​

text
POST /admin/user/add

接口参数说明 ​

Body 参数类型必填说明
idinteger否主键ID，新增时不传
usernamestring否登录账号，新增时必填
passwordstring否登录密码，新增时必填；修改时留空表示不修改
nicknamestring否用户昵称
avatarstring否头像相对路径
mobilestring否手机号
emailstring否邮箱
dept_idinteger否部门ID
statusinteger否状态 1启用 2禁用
is_superinteger否是否超级管理员 0否 1是
role_idsarray<integer>否角色ID列表

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 1,
    "created_at": "2026-09-25T10:00:00+08:00",
    "updated_at": "2026-09-25T10:00:00+08:00",
    "username": "admin",
    "nickname": "超级管理员",
    "avatar": "/files/2026/09/23/8f14e45fceea167a5a36dedd4bea2543.png",
    "mobile": "",
    "email": "",
    "dept_id": 0,
    "status": 1,
    "is_super": 0,
    "roles": [
      {
        "id": 1,
        "created_at": "2026-09-25T10:00:00+08:00",
        "updated_at": "2026-09-25T10:00:00+08:00",
        "name": "运营专员",
        "code": "operator",
        "parent_id": 0,
        "sort": 0,
        "status": 1,
        "remark": ""
      }
    ]
  }
}

响应参数说明 ​

响应字段类型说明
idinteger主键ID
created_atstring创建时间
updated_atstring更新时间
usernamestring登录账号
nicknamestring用户昵称
avatarstring头像访问地址（按当前默认存储动态生成）
mobilestring手机号
emailstring邮箱
dept_idinteger部门ID
statusinteger状态 1启用 2禁用
is_superinteger是否超级管理员 0否 1是
rolesarray<RoleItem>角色列表
roles[].idinteger主键ID
roles[].created_atstring创建时间
roles[].updated_atstring更新时间
roles[].namestring角色名称
roles[].codestring角色编码（唯一）
roles[].parent_idinteger上级角色ID，0 为顶级
roles[].sortinteger排序
roles[].statusinteger状态 1启用 2禁用
roles[].remarkstring备注

修改用户 ​

接口地址 ​

text
POST /admin/user/update

接口说明 ​

必须传 id；password 为空表示不修改密码。超级管理员不可被禁用或删除。

接口参数说明 ​

Body 参数类型必填说明
idinteger否主键ID，新增时不传
usernamestring否登录账号，新增时必填
passwordstring否登录密码，新增时必填；修改时留空表示不修改
nicknamestring否用户昵称
avatarstring否头像相对路径
mobilestring否手机号
emailstring否邮箱
dept_idinteger否部门ID
statusinteger否状态 1启用 2禁用
is_superinteger否是否超级管理员 0否 1是
role_idsarray<integer>否角色ID列表

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 1,
    "created_at": "2026-09-25T10:00:00+08:00",
    "updated_at": "2026-09-25T10:00:00+08:00",
    "username": "admin",
    "nickname": "超级管理员",
    "avatar": "/files/2026/09/23/8f14e45fceea167a5a36dedd4bea2543.png",
    "mobile": "",
    "email": "",
    "dept_id": 0,
    "status": 1,
    "is_super": 0,
    "roles": [
      {
        "id": 1,
        "created_at": "2026-09-25T10:00:00+08:00",
        "updated_at": "2026-09-25T10:00:00+08:00",
        "name": "运营专员",
        "code": "operator",
        "parent_id": 0,
        "sort": 0,
        "status": 1,
        "remark": ""
      }
    ]
  }
}

响应参数说明 ​

响应字段类型说明
idinteger主键ID
created_atstring创建时间
updated_atstring更新时间
usernamestring登录账号
nicknamestring用户昵称
avatarstring头像访问地址（按当前默认存储动态生成）
mobilestring手机号
emailstring邮箱
dept_idinteger部门ID
statusinteger状态 1启用 2禁用
is_superinteger是否超级管理员 0否 1是
rolesarray<RoleItem>角色列表
roles[].idinteger主键ID
roles[].created_atstring创建时间
roles[].updated_atstring更新时间
roles[].namestring角色名称
roles[].codestring角色编码（唯一）
roles[].parent_idinteger上级角色ID，0 为顶级
roles[].sortinteger排序
roles[].statusinteger状态 1启用 2禁用
roles[].remarkstring备注

删除用户 ​

接口地址 ​

text
POST /admin/user/delete

接口说明 ​

删除后同时清除该用户角色绑定并踢掉其全部在线会话。

接口参数说明 ​

Body 参数类型必填说明
idinteger是主键ID

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "code": 0,
    "msg": "success",
    "data": null
  }
}

响应参数说明 ​

成功时 data 为 null。

重置用户密码 ​

接口地址 ​

text
POST /admin/user/reset_password

接口说明 ​

重置后该用户全部在线会话立即失效。

接口参数说明 ​

Body 参数类型必填说明
idinteger是用户ID
passwordstring是新密码，至少 6 位

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "code": 0,
    "msg": "success",
    "data": null
  }
}

响应参数说明 ​

成功时 data 为 null。

踢用户下线 ​

接口地址 ​

text
POST /admin/user/kick

接口说明 ​

使该用户所有在线会话立即失效，超级管理员不可被踢。

接口参数说明 ​

Body 参数类型必填说明
idinteger是主键ID

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": {
    "code": 0,
    "msg": "success",
    "data": null
  }
}

响应参数说明 ​

成功时 data 为 null。