创建、获取、更新和删除企业部门

​

预期效果

​

接入流程简介

1. 获取应用凭证信息，获取应用 Client ID 和 Client Secret。
2. 申请接口权限，申请通讯录管理相关接口权限。
3. 获取应用访问凭证获取企业内部应用的access_token。调用接口时，通过accessToken鉴权调用者身份。
4. 调用通讯录相关API：
   1. 调用服务端API-创建部门接口，实现创建部门，获取部门dept_id。
      • 如果创建根部门的子部门，参数parent_id传1。本示例采用创建根部门下的子部门。
      • 如果创建的是其他部门的子部门，需要先调用获取部门列表接口，获取的部门ID作为parent_id的值。
   2. 根据部门dept_id，调用服务端API-获取部门详情接口，获取部门详情信息。
   3. 根据部门dept_id，调用服务端API-更新部门接口，实现更新部门信息。
   4. 根据部门dept_id，调用服务端API-删除部门接口，实现删除部门信息。

​

前提条件

​

步骤一：获取应用凭证

1. 选择目标应用，进入应用详情页，单击基础信息 > 凭证与基础信息。
2. 获取应用 Client ID 和 Client Secret。

​

步骤二：添加接口权限

​

步骤三：获取应用访问凭证accessToken

​

重要

• 服务端API差异详情参见旧版API VS 新版API。
• 服务端API接口SDK下载，详情参见服务端SDK下载。

public void getAccessToken() throws ApiException {
        DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.io/gettoken");
        OapiGettokenRequest req = new OapiGettokenRequest();
        req.setAppkey("dingxxxxxxxxxhgn");
        req.setAppsecret("9G_xxxxxxxxxxxxxxx1JDf0Qq3nexxxxxxxxGIO");
        req.setHttpMethod("GET");
        OapiGettokenResponse rsp = client.execute(req);
        System.out.println(rsp.getBody());
    }

​

步骤四：调用通讯录相关API

1. 调用服务端API-创建部门接口，实现创建部门，获取部门dept_id。
   public void deptCreate() throws ApiException {
           DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/department/create");
           OapiV2DepartmentCreateRequest req = new OapiV2DepartmentCreateRequest();
           req.setParentId(1L);
           req.setOuterDept(true);
           req.setHideDept(false);
           req.setCreateDeptGroup(true);
           req.setOrder(1L);
           req.setName("1019部门测试");
           req.setSourceIdentifier("1019部门测试");
           req.setOuterPermitUsers("manager7675,01472825524039877041");
           req.setOuterDeptOnlySelf(true);
           OapiV2DepartmentCreateResponse rsp = client.execute(req, "access_token");
           System.out.println(rsp.getBody());
       }
   
   • 如果创建根部门的子部门，参数parent_id传1。本示例采用创建根部门下的子部门。
   • 如果创建的是其他部门的子部门，需要先调用获取部门列表接口，获取的部门ID作为parent_id的值。
     public void departmentList() throws ApiException {
             DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/department/listsub");
             OapiV2DepartmentListsubRequest req = new OapiV2DepartmentListsubRequest();
             req.setDeptId(1L);
             req.setLanguage("zh_CN");
             OapiV2DepartmentListsubResponse rsp = client.execute(req, "access_token");
             System.out.println(rsp.getBody());
         }
     
2. 根据部门dept_id，调用服务端API-获取部门详情接口，获取部门详情信息。
   public void deptInfo() throws ApiException {
           DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/department/get");
           OapiV2DepartmentGetRequest req = new OapiV2DepartmentGetRequest();
           req.setDeptId(724960197L);
           req.setLanguage("zh_CN");
           OapiV2DepartmentGetResponse rsp = client.execute(req, "access_token");
           System.out.println(rsp.getBody());
       }
   
3. 根据部门dept_id，调用服务端API-更新部门接口，实现更新部门信息。
   public void deptModify() throws ApiException {
           DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/department/update");
           OapiV2DepartmentUpdateRequest req = new OapiV2DepartmentUpdateRequest();
           req.setDeptId(724960197L);
           req.setParentId(1L);
           req.setOuterDept(true);
           req.setHideDept(false);
           req.setCreateDeptGroup(true);
           req.setOrder(1L);
           req.setName("1019部门测试");
           req.setSourceIdentifier("1019部门测试");
           req.setOuterPermitUsers("manager7675,01472825524039877041");
           req.setOuterDeptOnlySelf(true);
           req.setLanguage("zh_CN");
           req.setAutoAddUser(true);
           req.setAutoApproveApply(true);
           req.setOrgDeptOwner("manager7675");
           OapiV2DepartmentUpdateResponse rsp = client.execute(req, "access_token");
           System.out.println(rsp.getBody());
       }
   
4. 根据部门dept_id，调用服务端API-删除部门接口，实现删除部门信息。
    public void deptDelete() throws ApiException {
           DingTalkClient client = new DefaultDingTalkClient("https://api.dingtalk.io/topapi/v2/department/delete");
           OapiV2DepartmentDeleteRequest req = new OapiV2DepartmentDeleteRequest();
           req.setDeptId(724960197L);
           OapiV2DepartmentDeleteResponse rsp = client.execute(req, "access_token");
           System.out.println(rsp.getBody());
       }
   
   说明
   • 当前部门内有成员或者该部门的子部门内有成员，不允许删除的。
   • 当前部门及其所有子部门都会被删除。
   • 部门删除后，对应的部门群会自动解散。