角色接口

角色管理相关接口。

角色列表

分页查询角色列表。

请求

GET /api/v1/roles

请求参数

参数	类型	必填	说明
pageNum	int	否	页码，默认 1
pageSize	int	否	每页条数，默认 10
name	string	否	角色名称，模糊查询
code	string	否	角色编码，模糊查询
status	int	否	状态：0-禁用 1-启用

响应

{
  "code": "00000",
  "msg": "成功",
  "data": {
    "total": 10,
    "list": [
      {
        "id": 1,
        "name": "管理员",
        "code": "ADMIN",
        "status": 1,
        "sort": 1,
        "dataScope": 1,
        "createTime": "2024-01-01 12:00:00"
      }
    ]
  }
}

---

角色详情

请求

GET /api/v1/roles/{id}

响应

{
  "code": "00000",
  "msg": "成功",
  "data": {
    "id": 1,
    "name": "管理员",
    "code": "ADMIN",
    "status": 1,
    "sort": 1,
    "dataScope": 1,
    "menuIds": [1, 2, 3],
    "customDeptIds": [1, 2, 3]
  }
}

---

新增角色

请求

POST /api/v1/roles

请求参数

{
  "name": "普通用户",
  "code": "USER",
  "status": 1,
  "sort": 2,
  "dataScope": 5,
  "menuIds": [1, 2, 3],
  "customDeptIds": [1, 2]
}

响应

{
  "code": "00000",
  "msg": "成功",
  "data": 2
}

---

修改角色

请求

PUT /api/v1/roles/{id}

响应

{
  "code": "00000",
  "msg": "成功"
}

---

删除角色

请求

DELETE /api/v1/roles

请求参数

{
  "ids": [1, 2, 3]
}

响应

{
  "code": "00000",
  "msg": "成功"
}

---

角色下拉列表

请求

GET /api/v1/roles/options

响应

{
  "code": "00000",
  "msg": "成功",
  "data": [
    { "value": 1, "label": "管理员" },
    { "value": 2, "label": "普通用户" }
  ]
}

---

分配菜单权限

请求

PUT /api/v1/roles/{id}/menus

请求参数

{
  "menuIds": [1, 2, 3, 4, 5]
}

响应

{
  "code": "00000",
  "msg": "成功"
}