跳转到主要内容
本文介绍了创建一个企业内部应用，使用通讯录管理提供的部门管理相关API，实现创建、获取、更新和删除企业部门等。

​
预期效果

部门信息展示如下图所示： 预期效果

​
接入流程简介

  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。

​
步骤二：添加接口权限

单击开发配置 > 权限管理，在权限搜索框中输入qyapi_manage_addresslist和qyapi_get_department_list，并申请权限。

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

​
重要

  • 服务端API差异详情参见旧版API VS 新版API。
  • 服务端API接口SDK下载，详情参见服务端SDK下载。
根据步骤一中的 Client ID 和 Client Secret，获取应用访问凭证获取企业内部应用的access_token。 
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://oapi.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://oapi.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://oapi.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://oapi.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://oapi.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());
    }
    说明
    • 当前部门内有成员或者该部门的子部门内有成员，不允许删除的。
    • 当前部门及其所有子部门都会被删除。
    • 部门删除后，对应的部门群会自动解散。