Skip to main content
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.
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.

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.
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.
1

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.
Di Open Platform, pemanggilannya adalah https://api.dingtalk.com/v1.0/oauth2/accessToken.Dengan asumsi domain YiDA organisasi Anda adalah https://your-org-private-yida-domain.com, pemanggilan edisi klaster menjadi:https://your-org-private-yida-domain.com/v1.0/oauth2/accessTokenaccess_token berlaku selama 2 jam secara default.
2

Panggil YiDA API dengan access_token

DingTalk Open Platform menyediakan SDK dalam Java, PHP, Python, dan .NET untuk developer. OpenAPI edisi klaster mendukung cara pemanggilan yang serupa.
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.
  1. 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.

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.
ModulStandar Server APIDeskripsi
Alur kerjaMulai proses persetujuan YiDAMulai proses persetujuan YiDA di DingTalk Open Platform.
Hapus instans alur kerjaHapus instans alur kerja.
Hentikan instans alur kerjaHentikan instans alur kerja.
Dapatkan daftar ID instansDapatkan daftar ID instans.
Dapatkan beberapa instans alur kerja secara massalDapatkan detail beberapa instans alur kerja berdasarkan ID-nya secara massal.
Dapatkan instans alur kerjaDapatkan informasi instans alur kerja dari YiDA.
Dapatkan instans alur kerja berdasarkan IDDapatkan detail instans alur kerja berdasarkan ID-nya.
FormulirDapatkan daftar formulir dari aplikasi tertentuDapatkan daftar formulir dari sebuah aplikasi secara paginasi.
Dapatkan informasi komponen dalam formulirDapatkan informasi komponen dalam formulir atau formulir alur kerja berdasarkan ID formulir.
Kueri data instans formulirKueri data instans formulir.
Simpan data formulirBuat instans formulir YiDA tanpa proses persetujuan.
Perbarui data formulirPerbarui data formulir.
Kueri data formulirKueri data formulir berdasarkan ID instans formulir.
Dapatkan nilai komponen karyawanDapatkan nilai komponen karyawan.
Dapatkan daftar definisi komponen formulirDapatkan daftar definisi komponen formulir.
Dapatkan data komponen subformulirDapatkan data komponen subformulir berdasarkan ID instans formulir dan ID komponen subformulir.
Hapus data formulirHapus data formulir.
Dapatkan beberapa ID instans formulirDapatkan beberapa ID instans formulir.
Dapatkan beberapa instans formulir secara massalDapatkan detail beberapa instans formulir secara massal.
Hapus beberapa instans formulir secara massalHapus beberapa rekaman instans formulir secara massal.
Buat beberapa instans formulir secara massalBuat beberapa rekaman instans formulir secara massal.
Perbarui nilai komponen dalam instans formulir secara massalPerbarui nilai komponen dalam instans formulir YiDA secara massal berdasarkan ID instans formulir.
Buat atau perbarui instans formulirBuat atau perbarui instans formulir menggunakan filter.
Kueri data instans formulir dengan kondisi kueri lanjutan (termasuk data komponen subformulir)Dapatkan detail instans formulir menggunakan filter.
Kueri data instans formulir dengan kondisi kueri lanjutan (tidak termasuk data komponen subformulir)Dapatkan detail instans formulir menggunakan filter, tidak termasuk data komponen subformulir.
Perbarui instans formulir secara massal dengan data instans formulirPerbarui informasi instans formulir secara massal menggunakan data komponen formulir YiDA.
Kueri catatan perubahan formulirKueri catatan perubahan formulir.
Tugas persetujuanDapatkan catatan persetujuanDapatkan catatan persetujuan.
Terima atau tolak tugas persetujuan YiDATerima atau tolak tugas persetujuan YiDA.
Alihkan tugasAlihkan tugas.
Kirim komentarKirim komentar pada instans formulir atau alur kerja.
Kueri komentar pada instans formulir YiDA secara massalKueri semua komentar pada formulir YiDA secara massal.
AplikasiKueri daftar aplikasi YiDAKueri daftar aplikasi YiDA di organisasi Anda.