cf_Ghbf

Appearance

角色管理 ​

角色维护、菜单权限分配与角色成员查询。

角色分页列表 ​

接口地址 ​

text
GET /admin/role/list

接口参数说明 ​

Query 参数类型必填说明
namestring否名称（模糊匹配）
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",
        "name": "运营专员",
        "code": "operator",
        "parent_id": 0,
        "sort": 0,
        "status": 1,
        "remark": ""
      }
    ],
    "total": 0
  }
}

响应参数说明 ​

响应字段类型说明
listarray<RoleItem>
list[].idinteger主键ID
list[].created_atstring创建时间
list[].updated_atstring更新时间
list[].namestring角色名称
list[].codestring角色编码（唯一）
list[].parent_idinteger上级角色ID，0 为顶级
list[].sortinteger排序
list[].statusinteger状态 1启用 2禁用
list[].remarkstring备注
totalinteger数据总数

角色树 ​

接口地址 ​

text
GET /admin/role/tree

接口说明 ​

角色通过 parent_id 构成树，上级角色自动继承后代角色的权限。

接口参数说明 ​

无请求参数。

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "data": {
        "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": ""
      },
      "children": [
        {
          "data": {
            "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": ""
          },
          "children": [
            {
              "data": {
              },
              "children": [
                {
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

响应参数说明 ​

成功时 data 为 null。

新增角色 ​

接口地址 ​

text
POST /admin/role/add

接口参数说明 ​

Body 参数类型必填说明
idinteger否主键ID，新增时不传
namestring是角色名称
codestring是角色编码（唯一）
parent_idinteger否上级角色ID
sortinteger否排序
statusinteger否状态 1启用 2禁用
remarkstring否备注

响应示例 ​

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",
    "name": "运营专员",
    "code": "operator",
    "parent_id": 0,
    "sort": 0,
    "status": 1,
    "remark": ""
  }
}

响应参数说明 ​

响应字段类型说明
idinteger主键ID
created_atstring创建时间
updated_atstring更新时间
namestring角色名称
codestring角色编码（唯一）
parent_idinteger上级角色ID，0 为顶级
sortinteger排序
statusinteger状态 1启用 2禁用
remarkstring备注

修改角色 ​

接口地址 ​

text
POST /admin/role/update

接口参数说明 ​

Body 参数类型必填说明
idinteger否主键ID，新增时不传
namestring是角色名称
codestring是角色编码（唯一）
parent_idinteger否上级角色ID
sortinteger否排序
statusinteger否状态 1启用 2禁用
remarkstring否备注

响应示例 ​

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",
    "name": "运营专员",
    "code": "operator",
    "parent_id": 0,
    "sort": 0,
    "status": 1,
    "remark": ""
  }
}

响应参数说明 ​

响应字段类型说明
idinteger主键ID
created_atstring创建时间
updated_atstring更新时间
namestring角色名称
codestring角色编码（唯一）
parent_idinteger上级角色ID，0 为顶级
sortinteger排序
statusinteger状态 1启用 2禁用
remarkstring备注

删除角色 ​

接口地址 ​

text
POST /admin/role/delete

接口参数说明 ​

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

响应示例 ​

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

响应参数说明 ​

成功时 data 为 null。

查询角色已绑定的菜单/按钮 ID ​

接口地址 ​

text
GET /admin/role/menus

接口参数说明 ​

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

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": [
    0
  ]
}

响应参数说明 ​

成功时 data 为 null。

给角色分配菜单/按钮权限 ​

接口地址 ​

text
POST /admin/role/assign_menus

接口说明 ​

全量覆盖式分配，menu_ids 为空表示清空该角色权限。

接口参数说明 ​

Body 参数类型必填说明
role_idinteger是角色ID
menu_idsarray<integer>否菜单/按钮ID列表（全量覆盖，空数组表示清空）

响应示例 ​

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

响应参数说明 ​

成功时 data 为 null。

查询角色下的用户 ID ​

接口地址 ​

text
GET /admin/role/users

接口参数说明 ​

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

响应示例 ​

json
{
  "code": 0,
  "msg": "success",
  "data": [
    0
  ]
}

响应参数说明 ​

成功时 data 为 null。