跳到主要内容

更新子管理员

更新子管理员配置


权限说明

仅支持专有轻流;

仅「超管accessToken」拥有调用权限。(权限组accessToken无法调用)

请求

**请求方式:**PUT

请求地址:https://自有域名/openApi/manager/sub/:subManagerId

请求地址中:subManagerId为需要替换的变量,根据实际获取值更新,示例如下:

PUT https://abcd.qingflow.com/openApi/manager/sub/9998

2.1 参数说明(路径参数):

参数类型必须说明
subManagerIdnumber子管理员ID

2.2 参数说明(查询参数):

2.3 请求头(Header)

参数必须说明
accessToken调用接口凭证。获取方法请查看“文档”

2.4 请求体(Body)

参数名类型必填说明
submanagerNamestring子管理员名称
authMemberConfigobject子管理员成员配置。
userIdsarray成员ID。
deptIdsarray部门ID。
roleIdsarray角色ID。
beingSubDepartBoolean是否包含子部门
authAppConfigobject应用权限配置
beingAuthAppBoolean应用权限是否开启,true:开启
beingEditAppBoolean编辑应用是否开启,true:开启。
beingAddAppBoolean添加应用是否开启,true:开启。
beingDelAppBoolean删除应用是否开启,true:开启。
beingDataManageBoolean数据管理是否开启,true:开启。
beingEditTagBoolean应用包编辑权限是否开启
authScopeobject应用/门户权限范围
appKeysarray应用key。
dashKeysarray仪表盘key。
tagIdsarray应用包ID。
authContactConfigobject通讯录权限配置
beingAuthContactBoolean通讯录权限是否开启,true:开启。
beingControlAllBoolean是否管理全量
deptsarray
deptldnumber
deptNamestring
rolesarray
roleldnumber
roleNamestring
beingIncludeSubDeptBoolean是否包含子部门
qingStoreAuthConfigobject
beingUseSolutionBoolean解决方案是否开启
beingUsePluginsBoolean插件是否开启
beingUseConnectionBoolean连接中心是否开启

2.5 请求体示例

{
"subManagerName": "xxxx",
"authMemberConfig": {
"userIds": [],
"deptIds": [],
"roleIds": [],
"beingSubDepart": true
},
"authAppConfig": {
"beingAuthApp": true,
"beingEditApp": true,
"beingAddApp": true,
"beingDelApp": true,
"beingDataManage": true,
"beingEditTag": false,
"authScope": {
"appKeys": ['xxxxx'],
"dashKeys": [],
"tagIds": [1234567, '78903']
}
},
"authContactConfig": {
"beingAuthContact": true,
"beingControlAll": false,
"depts": [{
"deptId": 4,
"deptName": "xxxxx"
}],
"roles": [{
"roleId": 24,
"roleName": "xxxxx"
}],
"beingIncludeSubDept": false
},
"qingStoreAuthConfig": {
"beingUseSolution": false,
"beingUsePlugins": false,
"beingUseConnection": false
}
}

#

返回

返回体

参数必含类型说明
errCodeint错误码,非0表示失败
errMsgstring错误描述
resultobject返回结果
subManamerIdnumber子管理员id

3.1 返回体示例

{
"errCode": 0,
"errMsg": "ok",
"result": {
"subManamerId":""
}
}

注意事项

  1. 所有参数:
  • 不传/传null,如"userIds":null时,不更新现有配置;
  • 传空字符串,如"userIds":" "时,删除全部成员;
  • 传具体值,如"userIds":[1,2,3]时,更新成员为:1、2、3。