> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Akses OpenAPI lokal dalam mode klaster

> Pelajari cara memanggil YiDA OpenAPI di lingkungan klaster YiDA Dedicated — mulai dari memperoleh domain, AK/SK, dan access_token, hingga mengonfigurasi SDK untuk integrasi API.

Data aplikasi di lingkungan klaster khusus tersimpan di lingkungan privat dan tidak dapat mengakses jaringan publik. Akibatnya, YiDA OpenAPI di DingTalk Open Platform tidak dapat mengambil data tersebut. Anda harus memanggil OpenAPI dari dalam lingkungan klaster. Secara garis besar, OpenAPI di lingkungan klaster sama dengan yang ada di DingTalk Open Platform, hanya berbeda pada host dan AK/SK yang digunakan.

Artikel ini menjelaskan cara memanggil YiDA OpenAPI di lingkungan klaster khusus.

<Note>
  Catatan:

  YiDA Dedicated saat ini membuka API layanan data frekuensi tinggi miliknya. Berdasarkan kemampuan API YiDA yang tersedia di DingTalk Open Platform per 31 Desember 2023, total tersedia 52 OpenAPI.
</Note>

## Alur pemanggilan

Pemanggilan YiDA API di lingkungan klaster serupa dengan di DingTalk Open Platform. Semua OpenAPI terkait di DingTalk Open Platform dipanggil melalui api.dingtalk.com. Untuk OpenAPI edisi klaster, cukup ganti api.dingtalk.com dengan domain YiDA edisi klaster milik organisasi Anda.

1. Dapatkan domain klaster YiDA Dedicated organisasi Anda, misalnya ddyd.corp.com.
2. Dapatkan AK dan SK edisi klaster organisasi Anda.

<Note>
  Hubungi admin DingTalk organisasi Anda. Masuk ke DingTalk Open Platform, cari "YiDA Dedicated Cluster" pada bagian aplikasi internal, lalu dapatkan informasi terkait dari aplikasi bernama **YiDA Dedicated Cluster Authentication App**.
</Note>

<Steps>
  <Step title="Langkah 1">
    Gunakan AK/SK yang diperoleh pada langkah sebelumnya untuk memanggil endpoint /v1.0/oauth2/accessToken dan mendapatkan access\_token aplikasi. Untuk parameter permintaan, lihat Dapatkan access\_token untuk aplikasi internal.

    <Warning>
      Di Open Platform, pemanggilannya adalah [https://api.dingtalk.com/v1.0/oauth2/accessToken](https://api.dingtalk.com/v1.0/oauth2/accessToken).

      Dengan asumsi domain YiDA organisasi Anda adalah [https://your-org-private-yida-domain.com](https://your-org-private-yida-domain.com), pemanggilan edisi klaster menjadi:

      [https://your-org-private-yida-domain.com/v1.0/oauth2/accessToken](https://your-org-private-yida-domain.com/v1.0/oauth2/accessToken)

      access\_token berlaku selama 2 jam secara default.
    </Warning>
  </Step>

  <Step title="Panggil YiDA API dengan access_token" />
</Steps>

DingTalk Open Platform menyediakan SDK dalam Java, PHP, Python, dan .NET untuk developer. OpenAPI edisi klaster mendukung cara pemanggilan yang serupa.

<Note>
  Aplikasi internal dan Aplikasi perusahaan pihak ketiga menggunakan Server-side SDK yang sama. Klik salah satu tautan berikut untuk mengunduhnya.

  * Aplikasi internal: Unduh Server-side SDK.
  * Aplikasi perusahaan pihak ketiga: Unduh Server-side SDK.
</Note>

5. Jika Anda menggunakan SDK dari DingTalk Open Platform, terapkan perubahan berikut:

Perubahan 1: Jika domain menggunakan http, atur config.protocol = "http".

Perubahan 2: Atur client.\_endpoint secara eksplisit ke domain YiDA sebenarnya milik organisasi Anda.

```java theme={"theme":{"light":"github-light","dark":"github-dark"}}
private static com.aliyun.dingtalkyida_2_0.Client createOpenApiClient() {
        Config config = new Config();
        config.regionId = "central";
        config.protocol = "http";
        config.connectTimeout = 60 * 1000;
        config.readTimeout = 60 * 1000;
        try {
            com.aliyun.dingtalkyida_2_0.Client client = new com.aliyun.dingtalkyida_2_0.Client(config);
          client._endpoint =  "your-org-private-yida-domain.com";
            return client;
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
```

## Daftar API klaster

YiDA menyediakan serangkaian kemampuan API terbuka yang kaya, sehingga developer dapat mengintegrasikan YiDA dengan sistem bisnis perusahaan. Saat ini, API terutama terbuka untuk formulir, alur kerja, dan aplikasi.

<table>
  <tr>
    <td>Modul</td>
    <td>Standar Server API</td>
    <td>Deskripsi</td>
  </tr>

  <tr>
    <td rowSpan={7}>Alur kerja</td>
    <td>Mulai proses persetujuan YiDA</td>
    <td>Mulai proses persetujuan YiDA di DingTalk Open Platform.</td>
  </tr>

  <tr>
    <td>Hapus instans alur kerja</td>
    <td>Hapus instans alur kerja.</td>
  </tr>

  <tr>
    <td>Hentikan instans alur kerja</td>
    <td>Hentikan instans alur kerja.</td>
  </tr>

  <tr>
    <td>Dapatkan daftar ID instans</td>
    <td>Dapatkan daftar ID instans.</td>
  </tr>

  <tr>
    <td>Dapatkan beberapa instans alur kerja secara massal</td>
    <td>Dapatkan detail beberapa instans alur kerja berdasarkan ID-nya secara massal.</td>
  </tr>

  <tr>
    <td>Dapatkan instans alur kerja</td>
    <td>Dapatkan informasi instans alur kerja dari YiDA.</td>
  </tr>

  <tr>
    <td>Dapatkan instans alur kerja berdasarkan ID</td>
    <td>Dapatkan detail instans alur kerja berdasarkan ID-nya.</td>
  </tr>

  <tr>
    <td rowSpan={20}>Formulir</td>
    <td>Dapatkan daftar formulir dari aplikasi tertentu</td>
    <td>Dapatkan daftar formulir dari sebuah aplikasi secara paginasi.</td>
  </tr>

  <tr>
    <td>Dapatkan informasi komponen dalam formulir</td>
    <td>Dapatkan informasi komponen dalam formulir atau formulir alur kerja berdasarkan ID formulir.</td>
  </tr>

  <tr>
    <td>Kueri data instans formulir</td>
    <td>Kueri data instans formulir.</td>
  </tr>

  <tr>
    <td>Simpan data formulir</td>
    <td>Buat instans formulir YiDA tanpa proses persetujuan.</td>
  </tr>

  <tr>
    <td>Perbarui data formulir</td>
    <td>Perbarui data formulir.</td>
  </tr>

  <tr>
    <td>Kueri data formulir</td>
    <td>Kueri data formulir berdasarkan ID instans formulir.</td>
  </tr>

  <tr>
    <td>Dapatkan nilai komponen karyawan</td>
    <td>Dapatkan nilai komponen karyawan.</td>
  </tr>

  <tr>
    <td>Dapatkan daftar definisi komponen formulir</td>
    <td>Dapatkan daftar definisi komponen formulir.</td>
  </tr>

  <tr>
    <td>Dapatkan data komponen subformulir</td>
    <td>Dapatkan data komponen subformulir berdasarkan ID instans formulir dan ID komponen subformulir.</td>
  </tr>

  <tr>
    <td>Hapus data formulir</td>
    <td>Hapus data formulir.</td>
  </tr>

  <tr>
    <td>Dapatkan beberapa ID instans formulir</td>
    <td>Dapatkan beberapa ID instans formulir.</td>
  </tr>

  <tr>
    <td>Dapatkan beberapa instans formulir secara massal</td>
    <td>Dapatkan detail beberapa instans formulir secara massal.</td>
  </tr>

  <tr>
    <td>Hapus beberapa instans formulir secara massal</td>
    <td>Hapus beberapa rekaman instans formulir secara massal.</td>
  </tr>

  <tr>
    <td>Buat beberapa instans formulir secara massal</td>
    <td>Buat beberapa rekaman instans formulir secara massal.</td>
  </tr>

  <tr>
    <td>Perbarui nilai komponen dalam instans formulir secara massal</td>
    <td>Perbarui nilai komponen dalam instans formulir YiDA secara massal berdasarkan ID instans formulir.</td>
  </tr>

  <tr>
    <td>Buat atau perbarui instans formulir</td>
    <td>Buat atau perbarui instans formulir menggunakan filter.</td>
  </tr>

  <tr>
    <td>Kueri data instans formulir dengan kondisi kueri lanjutan (termasuk data komponen subformulir)</td>
    <td>Dapatkan detail instans formulir menggunakan filter.</td>
  </tr>

  <tr>
    <td>Kueri data instans formulir dengan kondisi kueri lanjutan (tidak termasuk data komponen subformulir)</td>
    <td>Dapatkan detail instans formulir menggunakan filter, tidak termasuk data komponen subformulir.</td>
  </tr>

  <tr>
    <td>Perbarui instans formulir secara massal dengan data instans formulir</td>
    <td>Perbarui informasi instans formulir secara massal menggunakan data komponen formulir YiDA.</td>
  </tr>

  <tr>
    <td>Kueri catatan perubahan formulir</td>
    <td>Kueri catatan perubahan formulir.</td>
  </tr>

  <tr>
    <td rowSpan={5}>Tugas persetujuan</td>
    <td>Dapatkan catatan persetujuan</td>
    <td>Dapatkan catatan persetujuan.</td>
  </tr>

  <tr>
    <td>Terima atau tolak tugas persetujuan YiDA</td>
    <td>Terima atau tolak tugas persetujuan YiDA.</td>
  </tr>

  <tr>
    <td>Alihkan tugas</td>
    <td>Alihkan tugas.</td>
  </tr>

  <tr>
    <td>Kirim komentar</td>
    <td>Kirim komentar pada instans formulir atau alur kerja.</td>
  </tr>

  <tr>
    <td>Kueri komentar pada instans formulir YiDA secara massal</td>
    <td>Kueri semua komentar pada formulir YiDA secara massal.</td>
  </tr>

  <tr>
    <td>Aplikasi</td>
    <td>Kueri daftar aplikasi YiDA</td>
    <td>Kueri daftar aplikasi YiDA di organisasi Anda.</td>
  </tr>
</table>