角色添加

接口描述

该接口用于添加新角色，包括角色的名称、描述、权限等信息。

备注

在创建新角色前，后端服务需要验证角色的名称是否已存在，避免角色名称重复。

权限列表应该通过已定义的权限标识符进行验证，确保所有赋予的权限都是有效且存在的。

根据实际情况，可能需要对角色的名称、描述进行一定格式或内容的校验，以保证数据的合法性和一致性。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

X-Timestamp

integer

前端传递的时间戳

必需

默认值:

X-Auth-UUID

string

用户的UUID

必需

默认值:

Body 参数application/json

name

string

角色名

必需

displayName

string | null

展示名字

必需

permission

array[string]

权限组

必需

权限组为权限表字段 fy_permisison.name

示例

{
  "name": "string",
  "displayName": "string",
  "permission": [
    "string"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

output

string

状态名

必需

英文状态描述

code

integer

状态码

必需

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

message

string

状态描述

必需

对状态的中文描述

data

object (角色VO)

数据

必需

name

string

角色名

必需

displayName

string | null

展示名字

必需

permission

array[string]

权限组

必需

权限组为权限表字段 fy_permisison.name

示例

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

🟠404页面不存在

🟠405请求方法不支持

🟠401令牌验证错误

接口描述#

备注#

请求参数

示例代码

返回响应

接口描述

备注