绑定角色应用

POST/sys_base/platform/authority/bindAuthorityApps

构建时间2026-06-26 20:10:33（Asia/Shanghai）来源项目中间件文档 / 中间件后端来源仓../cl-midserver-2026来源提交号69b951a07311e75887b57e0400d888f89dd72cac

查看文档来源信息

• 来源目录：addons/sys_base/docs
• 来源文件：接口文档/05-绑定角色应用.md

详细说明

用于替换目标角色在当前模块下可绑定的应用实例列表。传空数组表示清空该角色当前模块下的应用绑定结果。

接口信息

项目	内容
请求方式	POST
请求路径	/sys_base/platform/authority/bindAuthorityApps
来源文件	接口文档/05-绑定角色应用.md

请求头

请求头	示例值	说明
Content-Type	application/json	请求体格式。
x-token	<jwt-token>	登录令牌。
app-id	mid-admin	当前应用 ID。
addons-type	sys_base	当前模块标识。

入参

参数	类型	是否必填	示例	说明
authorityId	number	是	20	目标角色 ID
appUuids	array<string>	否	["0031766249093132337"]	需要保留的应用 UUID 列表；传空数组表示清空绑定

参数说明

• authorityId 只能是当前用户可管理的普通角色。超级管理员用户可以维护任意普通角色。
• appUuids 中的每个应用实例都必须正式归属于目标角色所在模块。
• 应用实例的正式模块归属按以下顺序判定：
  1. app_wechat_apps_info.addons_type 与目标角色 addonsType 一致时，视为同模块。
  2. 如果 addons_type 不一致，但 app_wechat_apps_info.addons_id 命中了该模块下任一 app_model.id，同样视为同模块。
• 该判定口径与 GET /sys_base/platform/wechatAppsInfo/getWechatAppsInfoList?addonsType=... 保持一致，正式保证“列表能选即保存可绑”。

请求示例

{
  "authorityId": 20,
  "appUuids": [
    "0031766249093132337"
  ]
}

响应输出

{
  "code": 0,
  "msg": "绑定成功",
  "data": {}
}

字段说明

字段	类型	说明
code	number	业务状态码，0 表示成功
msg	string	返回消息
data	object	成功时返回空对象

curl 示例

curl --location --request POST 'http://127.0.0.1:8100/sys_base/platform/authority/bindAuthorityApps' \
--header 'Content-Type: application/json' \
--header 'x-token: <jwt-token>' \
--header 'app-id: mid-admin' \
--header 'addons-type: sys_base' \
--data-raw '{
  "authorityId": 20,
  "appUuids": [
    "0031766249093132337"
  ]
}'