开发者平台 / 视频管理系统（VMS）/ API功能接口定义 / 用户管理
4.1.8 获取所有角色
接口说明：
名称 | 内容 |
|---|---|
URL | https://xxx/tums/account/v1/queryRoleList |
功能说明 | 获取当前系统中的角色 |
使用限制 | 需要用户管理权限 |
请求参数：
参数名称 | 参数描述 | |
|---|---|---|
params grid | start Integer | 搜索开始的位置 |
limit Integer | 范围1~1000 | |
filterAnd Map | 与条件 可通过关键词“projectEqual”、“nameEqual”和“commonMenuEqual”、“sysMenuEqual”、“sysDefaultEqual”、“projectIn”，分别对项目名、角色名、通用权限、监控权限、系统默认值和角色关联项目包含进行筛选显示。 | |
filterOr Map | 或条件 可通过关键词“projectLike”对项目名进行模糊匹配，通过关键词“menuLike”对角色权限菜单名进行模糊匹配，通过关键词“nameLike”对角色名进行模糊匹配。 | |
sort List | 排序方式 | |
返回参数
参数名称 | 参数描述 | |
|---|---|---|
result List | roleId int | 角色ID |
roleName String | 角色名 | |
sysDefault bool | 是否为系统默认角色 | |
projectList List | 关联的项目信息，包含项目ID和项目名称 | |
menuList List | 角色可入功能菜单的列表，包含菜单ID和菜单名称 | |
error_code | 返回码，0 – 成功，其他- 失败，具体请参考返回码章节 | |
代码示例
https://xxx/tums/account/v1/queryRoleList
request:
{
"start":0,
"limit":20,
"filterAnd":{},
"filterOr":{},
"sort":[]
}
response:
{
"result": [
{
"roleId": 1,
"roleName": "超级管理员",
"sysDefault": 1
},
{
"roleId": 2,
"roleName": "系统操作员",
"sysDefault": 2
},
{
"roleId": 7,
"roleName": "testRole1",
"sysDefault": 0,
"projectList": [
{
"projectId": 1,
"projectName": "管理中心"
}
],
"menuList": [
{
"menuId": 1,
"menuName": "项目管理"
}
]
}
]
"error_code": 0
}
