获取角色列表

接口描述

此接口用于获取系统中所有角色的列表，也可以根据筛选条件获取角色信息。角色是分配给用户以决定其权限的标签。通过此接口，管理员可以查看系统中定义的所有角色及其相关信息，以便于管理和分配权限。

备注

需要有对应权限用户允许执行

接口权限

role:getRoleList

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

type

string

必需

[all/search/user/permission]

string

可选

type为 user、permission、search 生效

limit

number

可选

单页限制个数（默认20个）「不可超过100」

page

number

第几页

可选

order

string

可选

[asc/desc] 顺序/倒序

示例值:

asc

Header 参数

X-Timestamp

integer

前端传递的时间戳

必需

默认值:

X-Auth-UUID

string

用户的UUID

必需

默认值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

output

string

状态名

必需

英文状态描述

code

integer

状态码

必需

业务状态码（前三位为HTTP状态码）

message

string

状态描述

必需

对状态的中文描述

data

array[object (返回角色信息VO) {4}]

数据

必需

uuid

string

角色唯一识别码

必需

name

string

角色名

必需

displayName

string

角色名描述

必需

permission

array[string]

拥有权限

必需

示例

{
  "output": "string",
  "code": 0,
  "message": "string",
  "data": [
    {
      "uuid": "string",
      "name": "string",
      "displayName": "string",
      "permission": [
        "string"
      ]
    }
  ]
}

🟠404页面不存在

🟠405请求方法不支持

🟠401令牌验证错误

接口描述#

备注#

接口权限#

请求参数

示例代码

返回响应

接口描述

备注

接口权限