权限接口

接入须知

在接入权限接口前，需要先了解数字底座中的几个基础概念。应用接入数字底座时，通常需要先新建系统，在系统下添加应用资源，并根据应用自身的业务需求创建相应的菜单资源和按钮资源。

在授权方面，数字底座支持创建应用级、系统级以及公共（全局）角色。通过为角色添加成员，并将资源关联角色并选择合适的操作权限完成授权。同时，平台也支持资源直接面向组织架构进行授权。

了解上述概念后，可根据实际业务场景选择合适的权限接口进行接入。

接口

根据 systemName 获取应用列表

接口地址：http://{IP}:{PORT}/server-platform/services/rest/v1/app/listBySystemName

请求方法：GET

Content-Type: application/x-www-form-urlencoded

描述：根据 systemName 获取应用列表

请求参数：

参数名	参数类型	是否必须	描述	引入版本
systemName	string	true	系统英文名称	-

响应字段：

字段	类型	描述	引入版本
success	boolean	操作是否成功	-
code	int32	错误代码	-
msg	string	操作描述	-
data	object	操作成功返回的应用资源列表, 应用资源模型字段参考	-

请求示例：

http

GET http://{IP}:{PORT}/server-platform/services/rest/v1/app/listBySystemName?systemName=risecalendar

响应示例：

json

{
  "success": true,
  "code": 0,
  "msg": "操作成功",
  "data": [
    {
      "id": "1457054124007755776",
      "customId": "risecalendar",
      "systemId": "5d9b338a2aa34574ad5510ecd9407993",
      "name": "日程安排",
      "description": "",
      "enabled": true,
      "hidden": false,
      "iconUrl": "",
      "url": "https://test.youshengyun.com/calendar/",
      "url2": "",
      "resourceType": 0,
      "inherit": false,
      "tabIndex": 1,
      "guidPath": "1457054124007755776",
      "aliasName": "",
      "type": 1,
      "checked": false,
      "verifyUserName": "系统管理员",
      "showNumber": false,
      "numberUrl": "",
      "roleAdminUrl": "",
      "resourceAdminUrl": "",
      "opentype": 0,
      "iconData": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIAAAACACAYAAADDPmHLAAAACXBIWXMAAAsTAAALEwEAmpwYAAAFHGlUWHRYTUw6Y29tLmFkb2JlLnhtcAAAAAAAPD94cGFja2V0IGJlZ2luPSLvu78iIGlkPSJXNU0wTXBDZWhpSHpyZVN6TlRjemtjOWQiPz4gPHg6eG1wbWV0YSB4bWxuczp4PSJhZG9iZTpuczptZXRhLyIgeDp4bXB0az0iQWRvYmUgWE1QIENvcmUgNS42LWMxNDUgNzkuMTYzNDk5LCAyMDE4LzA4LzEzLTE2OjQwOjIyICAgICAgICAiPiA8cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPiA8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIiB4bWxuczp4bXA9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC8iIHhtbG5zOmRjPSJodHRwOi8vcHVybC5vcmcvZGMvZWxlbWVudHMvMS4xLyIgeG1sbnM6cGhvdG9zaG9wPSJodHRwOi8vbnMuYWRvYmUuY29tL3Bob3Rvc2hvcC8xLjAvIiB4bWxuczp4bXBNTT0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL21tLyIgeG1sbnM6c3RFdnQ9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9zVHlwZS9SZXNvdXJjZUV2ZW50IyIgeG1wOkNyZWF0b3JUb29sPSJBZG9iZSBQaG90b3Nob3AgQ0MgMjAxOSAoV2luZG93cykiIHhtcDpDcmVhdGVEYXRlPSIyMDIyLTExLTE2VDE2OjA2OjA0KzA4OjAwIiB4bXA6TW9kaWZ5RGF0ZT0iMjAyMi0xMS0xN1QxNzowNjo0NCswODowMCIgeG1wOk1ldGFkYXRhRGF0ZT0iMjAyMi0xMS0xN1QxNzowNjo0NCswODowMCIgZGM6Zm9ybWF0PSJpbWFnZS9wbmciIHBob3Rvc2hvcDpDb2xvck1vZGU9IjMiIHBob3Rvc2hvcDpJQ0NQcm9maWxlPSJzUkdCIElFQzYxOTY2LTIuMSIgeG1wTU06SW5zdGFuY2VJRD0ieG1wLmlpZDpmZDkwODU1MC04Mjg4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",
      "autoInit": false,
      "tenancyStatus": null,
      "parentId": null,
      "appId": "1457054124007755776"
    }
  ]
}

判断人员对资源是否有指定的操作权限

接口地址：http://{IP}:{PORT}/server-platform/services/rest/v1/personResource/hasPermission

请求方法：GET

Content-Type: application/x-www-form-urlencoded

描述：判断人员对资源是否有指定的操作权限

请求参数：

参数名	参数类型	是否必须	描述	引入版本
tenantId	string	true	租户id	-
personId	string	true	人员id	-
resourceId	string	true	资源id	-
authority	enum	true	权限类型 {@link AuthorityEnum} [Enum: HIDDEN("隐藏", 0) , BROWSE("浏览", 1) , MODIFY("维护", 2) , ADMIN("管理", 3) ]	-

响应字段：

字段	类型	描述	引入版本
success	boolean	操作是否成功	-
code	int32	错误代码	-
msg	string	操作描述	-
data	boolean	人员对资源是否有指定的操作权限	-

请求示例：

http

GET http://{IP}:{PORT}/server-platform/services/rest/v1/personResource/hasPermission?tenantId=1600827872962940928&personId=1600827912980795392&authority=BROWSE&resourceId=1457054124007755776

响应示例：

json

{
  "success": true,
  "code": 0,
  "msg": "操作成功",
  "data": true
}

判断人员对 customId 对应的资源是否有指定的操作权限

接口地址：http://{IP}:{PORT}/server-platform/services/rest/v1/personResource/hasPermissionByCustomId

请求方法：GET

Content-Type: application/x-www-form-urlencoded

描述：判断人员对 customId 对应的资源是否有指定的操作权限

请求参数：

参数名	参数类型	是否必须	描述	引入版本
tenantId	string	true	租户id	-
personId	string	true	人员id	-
customId	string	true	自定义id	-
authority	enum	true	权限类型 {@link AuthorityEnum} [Enum: HIDDEN("隐藏", 0) , BROWSE("浏览", 1) , MODIFY("维护", 2) , ADMIN("管理", 3) ]	-

响应字段：

字段	类型	描述	引入版本
success	boolean	操作是否成功	-
code	int32	错误代码	-
msg	string	操作描述	-
data	boolean	人员对资源是否有指定的操作权限	-

请求示例：

http

GET http://{IP}:{PORT}/server-platform/services/rest/v1/personResource/hasPermissionByCustomId?tenantId=1600827872962940928&personId=1600827912980795392&authority=BROWSE&customId=risecalendar

响应示例：

json

{
  "success": true,
  "code": 0,
  "msg": "操作成功",
  "data": true
}

递归获得某一资源下，人员有相应权限的前端菜单和按钮（树形）

接口地址：http://{IP}:{PORT}/server-platform/services/rest/v1/personResource/listMenusRecursively

请求方法：GET

Content-Type: application/x-www-form-urlencoded

描述：递归获得某一资源下，人员有相应权限的菜单和按钮（树形）

请求参数：

参数名	参数类型	是否必须	描述	引入版本
tenantId	string	true	租户id	-
personId	string	true	人员id	-
authority	enum	true	权限类型 {@link AuthorityEnum} [Enum: HIDDEN("隐藏", 0) , BROWSE("浏览", 1) , MODIFY("维护", 2) , ADMIN("管理", 3) ]	-
resourceId	string	true	资源id	-

响应字段：

字段	类型	描述	引入版本
success	boolean	操作是否成功	-
code	int32	错误代码	-
msg	string	操作描述	-
data	object	操作成功返回的前端菜单列表, 前端菜单模型字段参考	-

请求示例：

http

GET http://{IP}:{PORT}/server-platform/services/rest/v1/personResource/listMenusRecursively?tenantId=1600827872962940928&personId=1600827912980795392&authority=BROWSE&resourceId=1457054124007755776

响应示例：

json

{
  "success": true,
  "code": 0,
  "msg": "操作成功",
  "data": [
    {
      "name": "日程面板",
      "path": "/home",
      "redirect": "",
      "component": "@/views/calendar/index.vue",
      "meta": "{\n \"title\": \"日程面板\",\n \"icon\": \"ri-calendar-2-line\",\n \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "target": "",
      "children": [],
      "buttons": [
        {
          "name": "领导日程",
          "icon": null,
          "buttonId": "list-leader-calendar",
          "url": null,
          "eventName": null,
          "displayType": 0
        }
      ]
    },
    {
      "name": "设置自动分享人员",
      "path": "/autoShare",
      "redirect": "",
      "component": "@/views/setAutoSharePerson/index.vue",
      "meta": "{\n  \"title\": \"设置自动分享人员\",\n  \"icon\": \"ri-settings-2-line\",\n  \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "target": "",
      "children": [],
      "buttons": []
    },
    {
      "name": "我的分享",
      "path": "/myShare",
      "redirect": "",
      "component": "@/views/myShare/index.vue",
      "meta": "{\n  \"title\": \"我的分享\",\n  \"icon\": \"ri-share-line\",\n  \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "target": "",
      "children": [],
      "buttons": []
    },
    {
      "name": "收到的分享",
      "path": "/receivedShare",
      "redirect": "",
      "component": "@/views/receivedShare/index.vue",
      "meta": "{\n  \"title\": \"收到的分享\",\n  \"icon\": \"ri-arrow-down-line\",\n  \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "target": "",
      "children": [],
      "buttons": []
    }
  ]
}

递归获得 customId 对应的某一资源下，人员有相应权限的前端菜单和按钮（树形）

接口地址：http://{IP}:{PORT}/server-platform/services/rest/v1/personResource/listMenusRecursivelyByCustomId

请求方法：GET

Content-Type: application/x-www-form-urlencoded

描述：递归获得 customId 对应的某一资源下，人员有相应权限的前端菜单和按钮（树形）

请求参数：

参数名	参数类型	是否必须	描述	引入版本
tenantId	string	true	租户id	-
personId	string	true	人员id	-
authority	enum	true	权限类型 {@link AuthorityEnum} [Enum: HIDDEN("隐藏", 0) , BROWSE("浏览", 1) , MODIFY("维护", 2) , ADMIN("管理", 3) ]	-
customId	string	true	自定义id	-

响应字段：

字段	类型	描述	引入版本
success	boolean	操作是否成功	-
code	int32	错误代码	-
msg	string	操作描述	-
data	object	操作成功返回的前端菜单列表, 前端菜单模型字段参考	-

请求示例：

http

GET http://{IP}:{PORT}/server-platform/services/rest/v1/personResource/listMenusRecursivelyByCustomId?tenantId=1600827872962940928&personId=1600827912980795392&authority=BROWSE&customId=risecalendar

响应示例：

json

{
  "success": true,
  "code": 0,
  "msg": "操作成功",
  "data": [
    {
      "name": "日程面板",
      "path": "/home",
      "redirect": "",
      "component": "@/views/calendar/index.vue",
      "meta": "{\n \"title\": \"日程面板\",\n \"icon\": \"ri-calendar-2-line\",\n \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "target": "",
      "children": [],
      "buttons": [
        {
          "name": "领导日程",
          "icon": null,
          "buttonId": "list-leader-calendar",
          "url": null,
          "eventName": null,
          "displayType": 0
        }
      ]
    },
    {
      "name": "设置自动分享人员",
      "path": "/autoShare",
      "redirect": "",
      "component": "@/views/setAutoSharePerson/index.vue",
      "meta": "{\n  \"title\": \"设置自动分享人员\",\n  \"icon\": \"ri-settings-2-line\",\n  \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "target": "",
      "children": [],
      "buttons": []
    },
    {
      "name": "我的分享",
      "path": "/myShare",
      "redirect": "",
      "component": "@/views/myShare/index.vue",
      "meta": "{\n  \"title\": \"我的分享\",\n  \"icon\": \"ri-share-line\",\n  \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "target": "",
      "children": [],
      "buttons": []
    },
    {
      "name": "收到的分享",
      "path": "/receivedShare",
      "redirect": "",
      "component": "@/views/receivedShare/index.vue",
      "meta": "{\n  \"title\": \"收到的分享\",\n  \"icon\": \"ri-arrow-down-line\",\n  \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "target": "",
      "children": [],
      "buttons": []
    }
  ]
}

获得某一资源下，人员有相应操作权限的子资源集合

接口地址：http://{IP}:{PORT}/server-platform/services/rest/v1/personResource/listSubResources

请求方法：GET

Content-Type: application/x-www-form-urlencoded

描述：获得某一资源下，人员有相应操作权限的子资源集合

请求参数：

参数名	参数类型	是否必须	描述	引入版本
tenantId	string	true	租户id	-
personId	string	true	人员id	-
authority	enum	true	权限类型 {@link AuthorityEnum} [Enum: HIDDEN("隐藏", 0) , BROWSE("浏览", 1) , MODIFY("维护", 2) , ADMIN("管理", 3) ]	-
resourceId	string	false	资源id	-
resourceType	string	false	资源类型，为空时不筛选	-

响应字段：

字段	类型	描述	引入版本
success	boolean	操作是否成功	-
code	int32	错误代码	-
msg	string	操作描述	-
data	object	操作成功返回的资源（菜单、按钮等）列表, 资源模型字段参考	-

请求示例：

http

GET http://{IP}:{PORT}/server-platform/services/rest/v1/personResource/listSubResources?tenantId=1600827872962940928&personId=1600827912980795392&authority=BROWSE&resourceId=1457054124007755776

响应示例：

json

{
  "success": true,
  "code": 0,
  "msg": "操作成功",
  "data": [
    {
      "id": "1472600221002240000",
      "customId": "",
      "systemId": "5d9b338a2aa34574ad5510ecd9407993",
      "name": "日程面板",
      "description": "",
      "enabled": true,
      "hidden": false,
      "iconUrl": "",
      "url": "/home",
      "url2": "",
      "resourceType": 1,
      "inherit": true,
      "tabIndex": 0,
      "guidPath": "1457054124007755776,1472600221002240000",
      "appId": "1457054124007755776",
      "parentId": "1457054124007755776",
      "target": "",
      "component": "@/views/calendar/index.vue",
      "meta": "{\n \"title\": \"日程面板\",\n \"icon\": \"ri-calendar-2-line\",\n \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "redirect": ""
    },
    {
      "id": "1472600399679590400",
      "customId": "",
      "systemId": "5d9b338a2aa34574ad5510ecd9407993",
      "name": "设置自动分享人员",
      "description": "",
      "enabled": true,
      "hidden": false,
      "iconUrl": "",
      "url": "/autoShare",
      "url2": "",
      "resourceType": 1,
      "inherit": true,
      "tabIndex": 1,
      "guidPath": "1457054124007755776,1472600399679590400",
      "appId": "1457054124007755776",
      "parentId": "1457054124007755776",
      "target": "",
      "component": "@/views/setAutoSharePerson/index.vue",
      "meta": "{\n  \"title\": \"设置自动分享人员\",\n  \"icon\": \"ri-settings-2-line\",\n  \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "redirect": ""
    },
    {
      "id": "1472601193803943936",
      "customId": "",
      "systemId": "5d9b338a2aa34574ad5510ecd9407993",
      "name": "我的分享",
      "description": "",
      "enabled": true,
      "hidden": false,
      "iconUrl": "",
      "url": "/myShare",
      "url2": "",
      "resourceType": 1,
      "inherit": true,
      "tabIndex": 5,
      "guidPath": "1457054124007755776,1472601193803943936",
      "appId": "1457054124007755776",
      "parentId": "1457054124007755776",
      "target": "",
      "component": "@/views/myShare/index.vue",
      "meta": "{\n  \"title\": \"我的分享\",\n  \"icon\": \"ri-share-line\",\n  \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "redirect": ""
    },
    {
      "id": "1472601342223585280",
      "customId": "",
      "systemId": "5d9b338a2aa34574ad5510ecd9407993",
      "name": "收到的分享",
      "description": "",
      "enabled": true,
      "hidden": false,
      "iconUrl": "",
      "url": "/receivedShare",
      "url2": "",
      "resourceType": 1,
      "inherit": true,
      "tabIndex": 6,
      "guidPath": "1457054124007755776,1472601342223585280",
      "appId": "1457054124007755776",
      "parentId": "1457054124007755776",
      "target": "",
      "component": "@/views/receivedShare/index.vue",
      "meta": "{\n  \"title\": \"收到的分享\",\n  \"icon\": \"ri-arrow-down-line\",\n  \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "redirect": ""
    }
  ]
}

获得 customId 对应的某一资源下，人员有相应操作权限的子资源集合

接口地址：http://{IP}:{PORT}/server-platform/services/rest/v1/personResource/listSubResourcesByCustomId

请求方法：GET

Content-Type: application/x-www-form-urlencoded

描述：获得 customId 对应的某一资源下，人员有相应操作权限的子资源集合

请求参数：

参数名	参数类型	是否必须	描述	引入版本
tenantId	string	true	租户id	-
personId	string	true	人员id	-
authority	enum	true	权限类型 {@link AuthorityEnum} [Enum: HIDDEN("隐藏", 0) , BROWSE("浏览", 1) , MODIFY("维护", 2) , ADMIN("管理", 3) ]	-
customId	string	false	自定义id	-
resourceType	string	false	资源类型，为空时不筛选	-

响应字段：

字段	类型	描述	引入版本
success	boolean	操作是否成功	-
code	int32	错误代码	-
msg	string	操作描述	-
data	object	操作成功返回的资源（菜单、按钮等）列表, 资源模型字段参考	-

请求示例：

http

GET http://{IP}:{PORT}/server-platform/services/rest/v1/personResource/listSubResourcesByCustomId?tenantId=1600827872962940928&personId=1600827912980795392&authority=BROWSE&customId=risecalendar

响应示例：

json

{
  "success": true,
  "code": 0,
  "msg": "操作成功",
  "data": [
    {
      "id": "1472600221002240000",
      "customId": "",
      "systemId": "5d9b338a2aa34574ad5510ecd9407993",
      "name": "日程面板",
      "description": "",
      "enabled": true,
      "hidden": false,
      "iconUrl": "",
      "url": "/home",
      "url2": "",
      "resourceType": 1,
      "inherit": true,
      "tabIndex": 0,
      "guidPath": "1457054124007755776,1472600221002240000",
      "appId": "1457054124007755776",
      "parentId": "1457054124007755776",
      "target": "",
      "component": "@/views/calendar/index.vue",
      "meta": "{\n \"title\": \"日程面板\",\n \"icon\": \"ri-calendar-2-line\",\n \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "redirect": ""
    },
    {
      "id": "1472600399679590400",
      "customId": "",
      "systemId": "5d9b338a2aa34574ad5510ecd9407993",
      "name": "设置自动分享人员",
      "description": "",
      "enabled": true,
      "hidden": false,
      "iconUrl": "",
      "url": "/autoShare",
      "url2": "",
      "resourceType": 1,
      "inherit": true,
      "tabIndex": 1,
      "guidPath": "1457054124007755776,1472600399679590400",
      "appId": "1457054124007755776",
      "parentId": "1457054124007755776",
      "target": "",
      "component": "@/views/setAutoSharePerson/index.vue",
      "meta": "{\n  \"title\": \"设置自动分享人员\",\n  \"icon\": \"ri-settings-2-line\",\n  \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "redirect": ""
    },
    {
      "id": "1472601193803943936",
      "customId": "",
      "systemId": "5d9b338a2aa34574ad5510ecd9407993",
      "name": "我的分享",
      "description": "",
      "enabled": true,
      "hidden": false,
      "iconUrl": "",
      "url": "/myShare",
      "url2": "",
      "resourceType": 1,
      "inherit": true,
      "tabIndex": 5,
      "guidPath": "1457054124007755776,1472601193803943936",
      "appId": "1457054124007755776",
      "parentId": "1457054124007755776",
      "target": "",
      "component": "@/views/myShare/index.vue",
      "meta": "{\n  \"title\": \"我的分享\",\n  \"icon\": \"ri-share-line\",\n  \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "redirect": ""
    },
    {
      "id": "1472601342223585280",
      "customId": "",
      "systemId": "5d9b338a2aa34574ad5510ecd9407993",
      "name": "收到的分享",
      "description": "",
      "enabled": true,
      "hidden": false,
      "iconUrl": "",
      "url": "/receivedShare",
      "url2": "",
      "resourceType": 1,
      "inherit": true,
      "tabIndex": 6,
      "guidPath": "1457054124007755776,1472601342223585280",
      "appId": "1457054124007755776",
      "parentId": "1457054124007755776",
      "target": "",
      "component": "@/views/receivedShare/index.vue",
      "meta": "{\n  \"title\": \"收到的分享\",\n  \"icon\": \"ri-arrow-down-line\",\n  \"roles\": [\"systemAdmin\", \"user\"]\n}",
      "redirect": ""
    }
  ]
}

数据模型

应用资源

字段	类型	描述	引入版本
id	string	唯一标识	-
customId	string	自定义 id	-
name	string	名称	-
description	string	描述	-
enabled	boolean	启用状态	-
hidden	boolean	是否隐藏	-
iconUrl	string	图标	-
url	string	链接地址	-
url2	string	链接地址2	-
resourceType	enum	资源类型 {@link ResourceTypeEnum} [Enum: APP(0, "应用") , MENU(1, "菜单") , OPERATION(2, "按钮") , DATA_CATALOG(3, "数据目录") ]	-
inherit	boolean	是否为继承上级节点的权限	-
tabIndex	int32	排序	-
guidPath	string	由ID组成的父子关系列表(正序)，之间用逗号分隔	-
systemId	string	系统id	-
aliasName	string	资源别名	-
type	enum	分类：1、业务协同，2：事项办理，3：数据服务 {@link AppTypeEnum} [Enum: INFORMATION(0, "信息服务") , BUSINESS_COLLABORATION(1, "业务协同") , WORKFLOW(2, "事项办理") , DATA_SERVICE(3, "数据服务") ]	-
checked	boolean	是否审核通过	-
verifyUserName	string	审核人	-
showNumber	boolean	是否显示右上角数字，0为不显示，1为显示	-
numberUrl	string	获取数字链接	-
roleAdminUrl	string	角色管理的URL	-
resourceAdminUrl	string	资源管理的URL	-
opentype	enum	应用打开方式：0在桌面窗口打开；1在新浏览器窗口打开 {@link AppOpenTypeEnum} [Enum: DESKTOP(0, "桌面窗口") , BROWSE(1, "新浏览器窗口") ]	-
iconData	string	图标图片的base64	-
autoInit	boolean	是否自动租用应用	-
tenancyStatus	string	租用状态	-

菜单资源

字段	类型	描述	引入版本
id	string	唯一标识	-
customId	string	自定义 id	-
systemId	string	系统 id	-
name	string	名称	-
description	string	描述	-
enabled	boolean	启用状态	-
hidden	boolean	是否隐藏	-
iconUrl	string	图标	-
url	string	链接地址	-
url2	string	链接地址2	-
resourceType	enum	资源类型 {@link ResourceTypeEnum} [Enum: APP(0, "应用") , MENU(1, "菜单") , OPERATION(2, "按钮") , DATA_CATALOG(3, "数据目录") ]	-
inherit	boolean	是否为继承上级节点的权限	-
tabIndex	int32	排序	-
guidPath	string	由ID组成的父子关系列表(正序)，之间用逗号分隔	-
appId	string	应用id	-
parentId	string	父节点ID	-
target	string	打开模式	-
component	string	菜单部件	-
meta	string	元信息	-
redirect	string	重定向	-

按钮资源

字段	类型	描述	引入版本
id	string	唯一标识	-
customId	string	自定义 id	-
systemId	string	系统 id	-
name	string	名称	-
description	string	描述	-
enabled	boolean	启用状态	-
hidden	boolean	是否隐藏	-
iconUrl	string	图标	-
url	string	链接地址	-
url2	string	链接地址2	-
resourceType	enum	资源类型 {@link ResourceTypeEnum} [Enum: APP(0, "应用") , MENU(1, "菜单") , OPERATION(2, "按钮") , DATA_CATALOG(3, "数据目录") ]	-
inherit	boolean	是否为继承上级节点的权限	-
tabIndex	int32	排序	-
guidPath	string	由ID组成的父子关系列表(正序)，之间用逗号分隔	-
appId	string	应用id	-
parentId	string	父节点ID	-
displayType	enum	展示方式 [Enum: ICON_TEXT(0) , ICON(1) , TEXT(2) ]	-
eventName	string	按钮事件	-

前端菜单

字段	类型	描述	引入版本
name	string	名称	-
path	string	路径	-
redirect	string	重定向	-
component	string	菜单部件	-
meta	string	元信息	-
target	string	打开位置	-
children	array	子菜单	-
buttons	array	子按钮前端按钮模型字段参考	-

前端按钮

字段	类型	描述	引入版本
name	string	名称	-
icon	string	图标	-
buttonId	string	按钮自定义id	-
url	string	链接地址	-
eventName	string	事件名称	-
displayType	enum	展示方式 {@link OperationDisplayTypeEnum} [Enum: ICON_TEXT(0) , ICON(1) , TEXT(2) ]	-

权限接口 ​

接入须知 ​

接口 ​

根据 systemName 获取应用列表 ​

判断人员对资源是否有指定的操作权限 ​

判断人员对 customId 对应的资源是否有指定的操作权限 ​

递归获得某一资源下，人员有相应权限的前端菜单和按钮（树形） ​

递归获得 customId 对应的某一资源下，人员有相应权限的前端菜单和按钮（树形） ​

获得某一资源下，人员有相应操作权限的子资源集合 ​

获得 customId 对应的某一资源下，人员有相应操作权限的子资源集合 ​

数据模型 ​

应用资源 ​

菜单资源 ​

按钮资源 ​

前端菜单 ​

前端按钮 ​

权限接口

接入须知

接口

根据 systemName 获取应用列表

判断人员对资源是否有指定的操作权限

判断人员对 customId 对应的资源是否有指定的操作权限

递归获得某一资源下，人员有相应权限的前端菜单和按钮（树形）

递归获得 customId 对应的某一资源下，人员有相应权限的前端菜单和按钮（树形）

获得某一资源下，人员有相应操作权限的子资源集合

获得 customId 对应的某一资源下，人员有相应操作权限的子资源集合

数据模型

应用资源

菜单资源

按钮资源

前端菜单

前端按钮