新增

POST

/system/role

新增

请求参数

Header 参数

Authorization

string

可选

Body 参数application/json

系统角色

pageSize

integer <int32>

分页大小

可选

pageNum

integer <int32>

当前页数

可选

orderByColumn

string

排序列

可选

isAsc

string

可选

排序的方向desc或者asc

status

integer <int32>

可选

数据状态（1=禁用，0=启用）

sort

integer <int32>

可选

显示排序（升序排列）

remark

string

可选

备注说明（最大长度500字符）

tenantId

string

可选

租户ID（系统自动填充）

revision

integer <int64>

可选

版本号（更新时自动递增）

createdBy

integer <int64>

可选

创建人ID（系统自动填充）

createdTime

string <date-time>

可选

创建时间（系统自动填充）

updatedBy

integer <int64>

可选

更新人ID（系统自动填充）

updatedTime

string <date-time>

可选

更新时间（系统自动填充）

string

角色ID

可选

level

integer <int32>

级别

可选

>= 1

name

string

角色名称

必需

code

string

角色权限字符串

必需

defChecked

array[string]

默认选中的节点

必需

pageQuery

object (PageQuery)

分页查询实体类

可选

pageSize

integer <int32>

分页大小

可选

pageNum

integer <int32>

当前页数

可选

orderByColumn

string

排序列

可选

isAsc

string

可选

排序的方向desc或者asc

pageQuery

object (PageQuery)

分页查询实体类

可选

示例

{
    "pageSize": 0,
    "pageNum": 0,
    "orderByColumn": "string",
    "isAsc": "string",
    "status": 0,
    "sort": 0,
    "remark": "string",
    "tenantId": "string",
    "revision": 0,
    "createdBy": 0,
    "createdTime": "2019-08-24T14:15:22Z",
    "updatedBy": 0,
    "updatedTime": "2019-08-24T14:15:22Z",
    "id": "string",
    "level": 1,
    "name": "string",
    "code": "string",
    "defChecked": [
        "string"
    ],
    "pageQuery": {
        "pageSize": 0,
        "pageNum": 0,
        "orderByColumn": "string",
        "isAsc": "string",
        "pageQuery": {}
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://localhost:8080/system/role' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "pageSize": 0,
    "pageNum": 0,
    "orderByColumn": "string",
    "isAsc": "string",
    "status": 0,
    "sort": 0,
    "remark": "string",
    "tenantId": "string",
    "revision": 0,
    "createdBy": 0,
    "createdTime": "2019-08-24T14:15:22Z",
    "updatedBy": 0,
    "updatedTime": "2019-08-24T14:15:22Z",
    "id": "string",
    "level": 1,
    "name": "string",
    "code": "string",
    "defChecked": [
        "string"
    ],
    "pageQuery": {
        "pageSize": 0,
        "pageNum": 0,
        "orderByColumn": "string",
        "isAsc": "string",
        "pageQuery": {}
    }
}'

返回响应

🟢200成功

*/*

Body

返回结果集

code

integer <int32>

状态码

可选

status

boolean

状态信息

可选

msg

string

返回信息

可选

data

boolean

数据

可选

isSecurity

boolean

是否加密

可选

示例

{
    "code": 0,
    "status": true,
    "msg": "string",
    "data": true,
    "isSecurity": true
}

🟠403禁止访问

🔴500服务器错误

修改于 2025-07-01 16:53:11

编辑

获取列表