本页面提供了用户角色管理的 API 文档,您可以通过以下 API 调用来管理用户的角色。

获取角色列表

您可以使用以下 API 调用来获取所有角色的列表:

GET /api/v1/roles
  • 响应示例
{
  "data": [
    {
      "id": 1,
      "name": "管理员",
      "description": "拥有所有权限的角色"
    },
    {
      "id": 2,
      "name": "普通用户",
      "description": "仅拥有基本权限的角色"
    }
  ]
}

创建角色

您可以使用以下 API 调用来创建新的角色:

POST /api/v1/roles
  • 请求参数

    • name (string): 角色名称
    • description (string): 角色描述
  • 响应示例

{
  "data": {
    "id": 3,
    "name": "测试角色",
    "description": "测试角色描述"
  }
}

删除角色

您可以使用以下 API 调用来删除指定的角色:

DELETE /api/v1/roles/{id}
  • 请求参数

    • id (integer): 角色ID
  • 响应示例

{
  "message": "角色已成功删除"
}

更多关于用户角色管理的 API 文档,请访问用户角色管理 API 文档

用户角色管理