睿晨网

# 一、创建角色

# ① thinkphp框架接口

点击查看具体文档：【创建角色】

  1. 请求方式：post [用postman测试]
  2. 接口示例：
    本地路由地址：http://thinkphp.shop/admin/role
    本地路由示例：http://thinkphp.shop/admin/role (opens new window)
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数
参数 是否必填 类型 说明
status 是 int 状态值：0不可用，1可用
name 是 string 角色名称，最多30个字符
desc 否 string 角色描述，最多255个字符
  1. 返回
{
    "msg": "ok",
    "data": true
}

# ② eggjs框架接口

点击查看具体文档：【2. 完成创建角色、角色列表功能】

  1. 请求方式：post [用postman测试]
  2. 接口示例：
    本地路由地址：http://127.0.0.1:7001/shop/admin/role
    本地路由示例：http://127.0.0.1:7001/shop/admin/role (opens new window)
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数
参数 是否必填 类型 说明
status 是 int 状态值：0不可用，1可用
name 是 string 角色名称，最多30个字符
desc 否 string 角色描述，最多255个字符
  1. 返回
{
    "msg": "ok",
    "data": '创建角色成功'
}

# 二、修改角色

# ① thinkphp框架接口

点击查看具体文档：【修改角色】

  1. 请求方式：post [用postman测试]
  2. 接口示例：
    本地路由地址：http://thinkphp.shop/admin/role/:id
    本地路由示例：http://thinkphp.shop/admin/role/7 (opens new window) 7代表角色id
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数
参数 是否必填 类型 说明
status 是 int 状态值：0不可用，1可用
name 是 string 角色名称，最多30个字符
desc 否 string 角色描述，最多255个字符
  1. 返回
{
    "msg": "ok",
    "data": true
}

# ② eggjs框架接口

点击查看具体文档：【七、修改角色、删除角色、修改角色状态】

  1. 请求方式：post [用postman测试]
  2. 接口示例：
    本地路由地址：http://127.0.0.1:7001/shop/admin/role/:id
    本地路由示例：http://127.0.0.1:7001/shop/admin/role/7 (opens new window) 7代表角色id
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数
参数 是否必填 类型 说明
status 是 int 状态值：0不可用，1可用
name 是 string 角色名称，最多30个字符
desc 否 string 角色描述，最多255个字符
  1. 返回
{
    "msg": "ok",
    "data": true
}

# 三、修改角色状态

# ① thinkphp框架接口

点击查看具体文档：【修改角色状态】

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

# 四、删除角色

# ① thinkphp框架接口

点击查看具体文档：【删除角色】

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

# 五、给角色role配置权限rule

# ① thinkphp框架接口

点击查看具体文档：【给角色role配置权限rule】

  1. 请求方式：POST [用postman测试]
  2. 本地路由: http://thinkphp.shop/admin/role/set_rules
    本地路由地址：http://thinkphp.shop/admin/role/set_rules (opens new window)
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数
参数 是否必填 类型 说明
是 JSON 权限表id集合及角色id的json数据

在postman中，Body -> raw -> JSON -> 输入json数据:

{
  "id":2, // 角色id
  "rule_ids":[6,7,8,9] // 权限id集合
}
  1. 返回
{
    "msg": "ok",
    "data": true
}

# ② eggjs框架接口

点击查看具体文档：【二、给角色配置权限API】

  1. 请求方式：POST [用postman测试]
  2. 本地路由: http://127.0.0.1:7001/shop/admin/role/set_rules
    本地路由地址：http://127.0.0.1:7001/shop/admin/role/set_rules (opens new window)
  3. header头
参数 是否必填 类型 说明
token 是 String token值
  1. 请求参数
参数 是否必填 类型 说明
是 JSON 权限表id集合及角色id的json数据

在postman中，Body -> raw -> JSON -> 输入json数据:

{
  "id":2, // 角色id
  "rule_ids":[6,7,8,9] // 权限id集合
}
  1. 返回
{
    "msg": "ok",
    "data": true
}
更新时间: 2025年4月11日星期五下午3点35分