admin/apps/wisdom-legacy/openApi/system/addRole.openapi.json

{
  "openapi": "3.1.0",
  "info": {
    "title": "系统管理",
    "description": "系统管理—相关接口文档",
    "version": "1.0-SNAPSHOT"
  },
  "paths": {
    "/role": {
      "post": {
        "tags": ["角色管理API"],
        "summary": "新增角色",
        "operationId": "add_1",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SysRole"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/AjaxResult"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "SysRole": {
        "type": "object",
        "description": "角色对象",
        "properties": {
          "createIdBy": {
            "type": "integer",
            "format": "int64"
          },
          "createBy": {
            "type": "string"
          },
          "createTime": {
            "type": "string",
            "format": "date-time"
          },
          "updateIdBy": {
            "type": "integer",
            "format": "int64"
          },
          "updateBy": {
            "type": "string"
          },
          "updateTime": {
            "type": "string",
            "format": "date-time"
          },
          "remark": {
            "type": "string"
          },
          "params": {
            "type": "object",
            "additionalProperties": {}
          },
          "roleId": {
            "type": "integer",
            "format": "int64",
            "description": "角色ID"
          },
          "roleName": {
            "type": "string",
            "description": "角色名称",
            "maxLength": 30,
            "minLength": 0
          },
          "roleKey": {
            "type": "string",
            "description": "角色权限",
            "maxLength": 100,
            "minLength": 0
          },
          "roleSort": {
            "type": "integer",
            "format": "int32",
            "description": "角色排序"
          },
          "dataScope": {
            "type": "string",
            "description": "数据范围（1：所有数据权限；2：自定义数据权限；3：本部门数据权限；4：本部门及以下数据权限；5：仅本人数据权限）"
          },
          "menuCheckStrictly": {
            "type": "boolean",
            "description": "菜单树选择项是否关联显示（ 0：父子不互相关联显示 1：父子互相关联显示）"
          },
          "deptCheckStrictly": {
            "type": "boolean",
            "description": "部门树选择项是否关联显示（0：父子不互相关联显示 1：父子互相关联显示 ）"
          },
          "status": {
            "type": "string",
            "description": "角色状态（0正常 1停用）"
          },
          "delFlag": {
            "type": "string",
            "description": "删除标志（0代表存在 2代表删除）"
          },
          "flag": {
            "type": "boolean",
            "description": "用户是否存在此角色标识 默认不存在"
          },
          "menuIds": {
            "type": "array",
            "description": "菜单组",
            "items": {
              "type": "integer",
              "format": "int64"
            }
          },
          "deptIds": {
            "type": "array",
            "description": "部门组（数据权限）",
            "items": {
              "type": "integer",
              "format": "int64"
            }
          },
          "permissions": {
            "type": "array",
            "description": "角色菜单权限",
            "items": {
              "type": "string"
            },
            "uniqueItems": true
          }
        },
        "required": ["roleName"]
      },
      "AjaxResult": {
        "type": "object",
        "description": "接口返回对象",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32",
            "description": "状态码"
          },
          "msg": {
            "type": "string",
            "description": "提示语"
          },
          "data": {
            "description": "数据对象"
          }
        }
      }
    }
  }
}