睿晨网

# 一、权限列表

# ① thinkphp框架接口

点击查看具体文档：【权限列表】

  1. 请求方式：GET [用postman测试]
  2. 接口示例：
    本地路由地址：http://thinkphp.shop/admin/rule/:page?limit=[:limit]
    本地路由示例：http://thinkphp.shop/admin/rule/1?limit=100 (opens new window) 1代表第1页，100代表每页100条数据，由于本数据涉及无限极循环，可以不用分页的，就是列出全部数据即可。
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数
参数 是否必填 类型 说明
page 是 int 页码，默认1
limit 否 int 每页多少条数据，默认100
  1. 返回
  1. 关于数据返回的说明： 原本查询的权限数据类似这样的数据：
[
 {"id": 6,"pid": 0,"status": 1,"name": "管理员管理",...},
 {"id": 7, "pid": 6,"status": 1,"name": "删除管理员",...},
 {"id": 8, "pid": 6,"status": 1,"name": "管理员列表",...},
 {"id": 9, "pid": 0,"status": 1,"name": "角色管理",...},
 {"id": 10,"pid": 9,"status": 1,"name": "角色列表",...},
]

为了方便后续配置权限，需要将数据转成树形结构，方便前端使用

  1. 一维数组的树形结构，会增加一个level体现等级
[
    {"id": 6,"pid": 0,"status": 1,"name": "管理员管理",...,"level": 0},
    {"id": 7, "pid": 6,"status": 1,"name": "删除管理员",...,"level": 1},
    {"id": 8, "pid": 6,"status": 1,"name": "管理员列表",...,"level": 1},
    {"id": 9, "pid": 0,"status": 1,"name": "角色管理",...,"level": 0},
    {"id": 10,"pid": 9,"status": 1,"name": "角色列表",...,"level": 1},
]
  1. 二维数组的树形结构，增加一个children字段，体现子集
[
    {
        "id": 6,
        "pid": 0,
        "status": 1,
        "name": "管理员管理",
        ...
        "children": [
            {
                "id": 7,
                "pid": 6,
                "status": 1,
                "name": "删除管理员",
                ...
                "children": []
            },
            {
                "id": 8,
                "pid": 6,
                "status": 1,
                "name": "管理员列表",
                ...
                "children": []
            }
        ]
    },
    {
        "id": 9,
        "pid": 0,
        "status": 1,
        "name": "角色管理",
        ...
        "children": [
            {
                "id": 10,
                "pid": 9,
                "status": 1,
                "name": "角色列表",
                ...
                "children": []
            }
        ]
    }
]

# ② eggjs框架接口

点击查看具体文档：【四、权限列表API】

  1. 请求方式：GET [用postman测试]
  2. 接口示例：
    本地路由地址：http://127.0.0.1:7001/shop/admin/rule/:page?limit=[:limit]
    本地路由示例：http://127.0.0.1:7001/shop/admin/rule/1?limit=100 (opens new window) 1代表第1页，100代表每页100条数据，由于本数据涉及无限极循环，可以不用分页的，就是列出全部数据即可。
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数
参数 是否必填 类型 说明
page 是 int 页码，默认1
limit 否 int 每页多少条数据，默认100
  1. 返回
{
    "msg": "ok",
    "data": [
        {
            "create_time": "2025-04-10 17:13:54",
            "id": 30,
            "pid": 0,
            "status": 1,
            "name": "管理员管理",
            "frontname": "",
            "frontpath": "",
            "condition": "",
            "menu": 1,
            "order": 50,
            "icon": "",
            "method": "GET",
            "update_time": "2025-04-10T09:13:54.000Z",
            "children": [
                {
                    "create_time": "2025-04-10 17:14:07",
                    "id": 31,
                    "pid": 30,
                    "status": 1,
                    "name": "创建管理员",
                    "frontname": "",
                    "frontpath": "",
                    "condition": "",
                    "menu": 1,
                    "order": 50,
                    "icon": "",
                    "method": "POST",
                    "update_time": "2025-04-10T09:14:44.000Z",
                    "children": [],
                    "level": 1
                },
                {
                    "create_time": "2025-04-10 17:14:21",
                    "id": 32,
                    "pid": 30,
                    "status": 1,
                    "name": "修改管理员",
                    "frontname": "",
                    "frontpath": "",
                    "condition": "",
                    "menu": 1,
                    "order": 50,
                    "icon": "",
                    "method": "POST",
                    "update_time": "2025-04-10T09:14:49.000Z",
                    "children": [],
                    "level": 1
                }
            ],
            "level": 0
        },
        {
            "create_time": "2025-04-10 17:14:37",
            "id": 33,
            "pid": 0,
            "status": 1,
            "name": "角色管理",
            "frontname": "",
            "frontpath": "",
            "condition": "",
            "menu": 1,
            "order": 50,
            "icon": "",
            "method": "GET",
            "update_time": "2025-04-10T09:14:37.000Z",
            "children": [
                {
                    "create_time": "2025-04-10 17:15:10",
                    "id": 34,
                    "pid": 33,
                    "status": 1,
                    "name": "创建角色",
                    "frontname": "",
                    "frontpath": "",
                    "condition": "",
                    "menu": 0,
                    "order": 50,
                    "icon": "",
                    "method": "GET",
                    "update_time": "2025-04-10T09:15:10.000Z",
                    "children": [],
                    "level": 1
                }
            ],
            "level": 0
        }
    ]
}

# 二、创建权限

# ① thinkphp框架接口

点击查看具体文档：【创建权限】

  1. 请求方式：POST [用postman测试]
  2. 接口示例：
    本地路由地址：http://thinkphp.shop/admin/rule
    本地路由示例：http://thinkphp.shop/admin/rule (opens new window)
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数
参数 是否必填 类型 说明
pid 是 int 父级id，必填
status 否 int 可用状态，0不可用，1可用，可不填，默认：1
name 是 string 权限名称（后台栏目或者功能名称），最多100个字符，必填
frontname 否 string 前端路由name值，最多100个字符，可不填
frontpath 否 string 前端路由路径，最多100个字符，可不填
condition 否 string 路由方法，最多255个字符，可不填
menu 否 int 是否为菜单，0不是，1是，可不填，默认：1
order 否 int 排序，大于等于0，可不填，默认：50
icon 否 string 图标名称，最多100个字符，可不填
method 否 string 可不填，要填只能是：POST,GET,PUT,DELETE 中的一个
  1. 返回
{
    "msg": "ok",
    "data": true
}

# ② eggjs框架接口

点击查看具体文档：【一、创建权限】

  1. 请求方式：POST [用postman测试]
  2. 接口示例：
    本地路由地址：http://127.0.0.1:7001/shop/admin/rule
    本地路由示例：http://127.0.0.1:7001/shop/admin/rule (opens new window)
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数
参数 是否必填 类型 说明
pid 是 int 父级id，必填
status 否 int 可用状态，0不可用，1可用，可不填，默认：1
name 是 string 权限名称（后台栏目或者功能名称），最多100个字符，必填
frontname 否 string 前端路由name值，最多100个字符，可不填
frontpath 否 string 前端路由路径，最多100个字符，可不填
condition 否 string 路由方法，最多255个字符，可不填
menu 否 int 是否为菜单，0不是，1是，可不填，默认：1
order 否 int 排序，大于等于0，可不填，默认：50
icon 否 string 图标名称，最多100个字符，可不填
method 否 string 可不填，要填只能是：POST,GET,PUT,DELETE 中的一个
  1. 返回
{
    "msg": "ok",
    "data": "创建权限成功"
}

# 三、修改权限

# ① thinkphp框架接口

点击查看具体文档：【修改权限】

  1. 请求方式：POST [用postman测试]
  2. 接口示例：
    本地路由地址：http://thinkphp.shop/admin/rule/:id
    本地路由示例：http://thinkphp.shop/admin/rule/23 (opens new window) 23表示的是权限id
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数
参数 是否必填 类型 说明
pid 是 int 父级id，必填
status 否 int 可用状态，0不可用，1可用，可不填，默认：1
name 是 string 权限名称（后台栏目或者功能名称），最多100个字符，必填
frontname 否 string 前端路由name值，最多100个字符，可不填
frontpath 否 string 前端路由路径，最多100个字符，可不填
condition 否 string 路由方法，最多255个字符，可不填
menu 否 int 是否为菜单，0不是，1是，可不填，默认：1
order 否 int 排序，大于等于0，可不填，默认：50
icon 否 string 图标名称，最多100个字符，可不填
method 否 string 可不填，要填只能是：POST,GET,PUT,DELETE 中的一个
  1. 返回
{
    "msg": "ok",
    "data": true
}

# ② eggjs框架接口

点击查看具体文档：【三、修改权限】

  1. 请求方式：POST [用postman测试]
  2. 接口示例：
    本地路由地址：http://127.0.0.1:7001/shop/admin/rule/:id
    本地路由示例：http://127.0.0.1:7001/shop/admin/rule/23 (opens new window) 23表示的是权限id
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数
参数 是否必填 类型 说明
pid 是 int 父级id，必填
status 否 int 可用状态，0不可用，1可用，可不填，默认：1
name 是 string 权限名称（后台栏目或者功能名称），最多100个字符，必填
frontname 否 string 前端路由name值，最多100个字符，可不填
frontpath 否 string 前端路由路径，最多100个字符，可不填
condition 否 string 路由方法，最多255个字符，可不填
menu 否 int 是否为菜单，0不是，1是，可不填，默认：1
order 否 int 排序，大于等于0，可不填，默认：50
icon 否 string 图标名称，最多100个字符，可不填
method 否 string 可不填，要填只能是：POST,GET,PUT,DELETE 中的一个
  1. 返回
{
    "msg": "ok",
    "data": "修改权限成功"
}

# 四、修改权限可用状态

# ① thinkphp框架接口

点击查看具体文档：【修改权限可用状态】

  1. 请求方式：post [用postman测试]
  2. 接口示例：
    本地路由地址：http://thinkphp.shop/admin/rule/:id/update_status
    本地路由示例：http://thinkphp.shop/admin/rule/23/update_status (opens new window) 23代表权限id
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数
参数 是否必填 类型 说明
status 是 int 状态值：0不可用，1可用
  1. 返回
{
    "msg": "ok",
    "data": true
}

# ② eggjs框架接口

点击查看具体文档：【二、权限列表和修改权限状态】

  1. 请求方式：post [用postman测试]
  2. 接口示例：
    本地路由地址：http://127.0.0.1:7001/shop/admin/rule/:id/update_status
    本地路由示例：http://127.0.0.1:7001/shop/admin/rule/23/update_status (opens new window) 23代表权限id
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数
参数 是否必填 类型 说明
status 是 int 状态值：0不可用，1可用
  1. 返回
{
    "msg": "ok",
    "data": "修改权限状态成功"
}

# 五、删除权限

# ① thinkphp框架接口

点击查看具体文档：【删除权限】

  1. 请求方式：POST [用postman测试]
  2. 本地路由: http://thinkphp.shop/admin/rule/:id/delete
    本地路由地址：http://thinkphp.shop/admin/rule/6/delete (opens new window) 6为权限的id
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数：
    请求体body无需传递参数、只需传递id即可，已经在网址传递了id值
  2. 返回
{
   "msg": "ok",
   "data": true
}

# ② eggjs框架接口

点击查看具体文档：【五、删除权限（最终代码）】

  1. 请求方式：POST [用postman测试]
  2. 本地路由: http://127.0.0.1:7001/shop/admin/rule/:id/delete
    本地路由地址：http://127.0.0.1:7001/shop/admin/rule/6/delete (opens new window) 6为权限的id
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数：
    请求体body无需传递参数、只需传递id即可，已经在网址传递了id值
  2. 返回
{
   "msg": "ok",
   "data": true
}
更新时间: 2025年4月14日星期一晚上7点25分