Buat, ambil, perbarui, dan hapus departemen

​

Hasil yang diharapkan

​

Alur integrasi

1. Dapatkan kredensial aplikasi untuk memperoleh client ID dan Client Secret.
2. Ajukan permintaan izin API yang terkait dengan pengelolaan Kontak.
3. Dapatkan kredensial akses untuk memperoleh access_token aplikasi internal. Saat Anda memanggil API, access token digunakan untuk mengautentikasi pemanggil.
4. Panggil API Kontak:
   1. Panggil Server API Buat departemen untuk membuat departemen dan memperoleh dept_id.
      • Untuk membuat subdepartemen di bawah departemen root, atur parent_id ke 1. Contoh ini membuat subdepartemen di bawah departemen root.
      • Untuk membuat subdepartemen di bawah departemen lain, panggil terlebih dahulu Dapatkan daftar departemen untuk memperoleh ID departemen, lalu teruskan sebagai nilai parent_id.
   2. Panggil Server API Dapatkan detail departemen dengan dept_id untuk mengambil detail departemen.
   3. Panggil Server API Perbarui departemen dengan dept_id untuk memperbarui informasi departemen.
   4. Panggil Server API Hapus departemen dengan dept_id untuk menghapus departemen.

​

Prasyarat

​

Langkah 1: Dapatkan kredensial aplikasi

1. Pilih aplikasi target dan buka halaman detail aplikasi. Klik Basic information > Credentials and basic information.
2. Dapatkan client ID dan Client Secret.

​

Langkah 2: Tambahkan izin API

​

Langkah 3: Dapatkan access token

​

Penting

• Untuk detail perbedaan antara Server API lama dan yang baru, lihat Legacy API vs. new API.
• Untuk mengunduh Server API SDK, lihat Download the Server-side 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());
    }

​

Langkah 4: Panggil API Kontak

1. Panggil Server API Buat departemen untuk membuat departemen dan memperoleh 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("Departemen Uji 1019");
           req.setSourceIdentifier("Departemen Uji 1019");
           req.setOuterPermitUsers("manager7675,01472825524039877041");
           req.setOuterDeptOnlySelf(true);
           OapiV2DepartmentCreateResponse rsp = client.execute(req, "access_token");
           System.out.println(rsp.getBody());
       }
   
   • Untuk membuat subdepartemen di bawah departemen root, atur parent_id ke 1. Contoh ini membuat subdepartemen di bawah departemen root.
   • Untuk membuat subdepartemen di bawah departemen lain, panggil terlebih dahulu Dapatkan daftar departemen untuk memperoleh ID departemen, lalu teruskan sebagai nilai 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. Panggil Server API Dapatkan detail departemen dengan dept_id untuk mengambil detail departemen.
   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. Panggil Server API Perbarui departemen dengan dept_id untuk memperbarui informasi departemen.
   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("Departemen Uji 1019");
           req.setSourceIdentifier("Departemen Uji 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. Panggil Server API Hapus departemen dengan dept_id untuk menghapus departemen.
    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());
       }
   
   Catatan
   • Departemen tidak dapat dihapus jika berisi pengguna atau jika salah satu subdepartemennya berisi pengguna.
   • Departemen tersebut beserta semua subdepartemennya akan dihapus.
   • Setelah departemen dihapus, Obrolan Departemen yang bersangkutan otomatis dibubarkan.