文档中心 > API类目 > 钉钉API

dingtalk.oapi.authorization.rbac.role.create (rbac模型创建管理组)

rbac模型创建管理组

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	描述
open_role_create	OpenRoleCreateVo	必须		管理组详情
open_action OpenActionVo 可选 aciton列表 └ action_ids String [] 可选 ["action1"] acitonId列表 open_condition OpenConditionVo 可选 conditon open_contact_scope OpenContactScopeVo 可选 contactScope └ include_self_manage_depts Boolean 可选 false 主管能管理的部门 └ userids String [] 可选 ["staff001"] 可管理的员工列表 └ include_member_depts Boolean 可选 false 员工所在的部门 └ dept_ids Number [] 可选 [3423,1122] 可管理的指定部门 └ open_role_name String 可选 IT管理组管理组名 └ open_role_id String 可选 rolexxx 管理组id,注意:创建的时候不要填写 └ open_resources String [] 可选 ["microapp.-24.baseAction.base.*"] 资源列表 open_members OpenMemberVo [] 可选成员列表 └ member_type String 可选 user 成员类型 └ member_id String 可选 staff001 成员id └ belong_corpid String 可选 dinge65814936dd6f1c8 member所属组织 └ operate_userid String 可选 staff002 操作人userid
agent_id	String	必须	微应用agenId,需要联系权限平台配置	微应用agenId,需要联系权限平台配置

响应参数

名称	类型	示例值	描述
result	DingOpenResult	DingOpenResult	系统自动生成
└ result String rolexxx 管理组id └ errcode Number 0 errcode └ errmsg String ok erromsg └ success Boolean true 请求状态

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/authorization/rbac/role/create");
OapiAuthorizationRbacRoleCreateRequest req = new OapiAuthorizationRbacRoleCreateRequest();
OpenRoleCreateVo obj1 = new OpenRoleCreateVo();
OpenActionVo obj2 = new OpenActionVo();
obj2.setActionIds(""action1"");
OpenConditionVo obj3 = new OpenConditionVo();
OpenContactScopeVo obj4 = new OpenContactScopeVo();
obj4.setIncludeSelfManageDepts(false);
obj4.setUserids(""staff001"");
obj4.setIncludeMemberDepts(false);
obj4.setDeptIds(new Long[] { 3423,1122 };
);
obj3.setOpenContactScope(obj4);
obj2.setOpenCondition(obj3);
obj1.setOpenAction(obj2);
obj1.setOpenRoleName("IT管理组");
obj1.setOpenRoleId("rolexxx");
obj1.setOpenResources(""microapp.-24.baseAction.base.*"");
List<OpenMemberVo> list6 = new ArrayList<OpenMemberVo>();
OpenMemberVo obj7 = new OpenMemberVo();
list6.add(obj7);
obj7.setMemberType("user");
obj7.setMemberId("staff001");
obj7.setBelongCorpid("dinge65814936dd6f1c8");
obj7.setOperateUserid("staff002");
obj1.setOpenMembers(list6);
req.setOpenRoleCreate(obj1);
req.setAgentId("微应用agenId,需要联系权限平台配置");
OapiAuthorizationRbacRoleCreateResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

JSON示例

{
    "result":{
        "result":"rolexxx",
        "errcode":0,
        "errmsg":"ok",
        "success":true
    }
}

异常示例

JSON示例

{
    "errcode":88,
    "errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.authorization.rbac.role.create (rbac模型创建管理组)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ