Konektor HTTP

Fitur	Paket Luang	Edisi Basic	Edisi Professional	Edisi Dedicated
Konektor HTTP	1	1	Tidak terbatas	Tidak terbatas

Jika konektor resmi DingTalk belum memenuhi kebutuhan Anda dan Anda perlu segera mengintegrasikan aplikasi DingTalk, sistem internal, atau sistem pihak ketiga, buat konektor kustom melalui YiDA Connector Factory.

Langkah 1: Buat konektor

Langkah 1

Masuk ke YiDA workbench sebagai Admin.

Langkah 2

Klik tombol Manajemen platform di sudut kanan atas untuk membuka halaman manajemen platform.

Langkah 3

Klik Connector Factory pada menu kiri, klik Buat konektor, lalu pilih Konektor HTTP.

Konfigurasikan informasi dasar konektor sesuai detail berikut, lalu klik Berikutnya

Konfigurasikan Metode autentikasi sesuai detail berikut

Tipe autentikasi	Deskripsi
Tanpa autentikasi	Tanpa autentikasi berarti tidak diperlukan kredensial untuk memanggil API. Umumnya digunakan untuk API publik.
Basic authentication	Otorisasi HTTP Standar. Header permintaan berisi kredensial yang digunakan server untuk memverifikasi identitas user agent. Tambahkan informasi akun dan kata sandi berenkode Base64 ke header, contohnya `Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l`. Format encoding: `account:password`. Anda hanya perlu mengonfigurasikan label untuk bidang akun dan kata sandi, yang menampilkan panduan bagi pengguna saat mendaftarkan kredensial. • Label username • Label password
API key	Metode autentikasi API key. API key berlaku jangka panjang (harap simpan dengan aman). Pemohon membuat secret key di sistem target, kemudian pengembang dapat menggunakan kredensial ini untuk memanggil API publik yang mendukung metode autentikasi tersebut. • Label parameter: Ditampilkan sebagai panduan saat mengonfigurasikan kredensial. • Nama parameter: Nama apiKey yang diperlukan oleh sistem. • Lokasi parameter: Pilih apakah kredensial dilampirkan sebagai Parameter kueri atau di header, sesuai kebutuhan sistem target.
Alibaba Cloud API Gateway	Setelah konektor dibuat, tambahkan templat kredensial. Setelah App Code dimasukkan ke templat, Anda dapat memanggil API Alibaba Cloud yang sesuai. Untuk informasi lebih lanjut, lihat Call APIs by using AppCode authentication.
Autentikasi DingTalk Open Platform	Setelah konektor dibuat, tambahkan templat kredensial. Setelah `App Key` dan `App Secret` dimasukkan ke templat, Anda dapat memanggil API DingTalk Open Platform (termasuk sebagian API YiDA). Setelah templat kredensial ditambahkan, YiDA secara otomatis membuat `access_token` melalui autentikasi dan menambahkannya ke parameter `Header` `x-acs-dingtalk-access-token` pada setiap permintaan. Anda tidak perlu membuatnya lagi. Untuk informasi lebih lanjut, lihat DingTalk app development process.
DingTalk Zero Trust Gateway	Untuk detail penggunaan DingTalk Zero Trust Gateway, lihat DingTalk Open Platform - Zero Trust Gateway authentication.

Langkah 2: Buat tindakan

Pada halaman tindakan, klik Buat tindakan, lalu konfigurasikan pengaturan berdasarkan informasi berikut.

Nama	Deskripsi
Informasi dasar	Konfigurasikan informasi dasar untuk tindakan saat ini. • Pengenal unik: Digunakan untuk membedakan antar tindakan. • Nama tindakan: Nama dari tindakan. • Deskripsi tindakan: Deskripsi dari tindakan.
Permintaan API	Konfigurasikan endpoint API yang dipanggil tindakan saat ini ketika dipicu. • URL permintaan: Tautan permintaan API. Domain permintaan diisi otomatis dari domain konektor. • Metode HTTP: Mendukung GET, POST, DELETE, PUT, HEAD, OPTIONS, PATCH, dan metode lainnya. • Query: Parameter permintaan, biasanya ditambahkan setelah tanda tanya `?` pada URL. Klik tanda plus untuk menambahkannya. • Body: Untuk permintaan POST dan metode serupa, bidang Body juga dapat disertakan. Mendukung parsing menggunakan JSON. • Headers: Anda dapat menyesuaikan header permintaan tambahan di sini. Saat ini hanya konfigurasi statis yang didukung. • Path: Variabel pada URL yang diapit kurung kurawal, seperti `{pathParam}`, dengan `pathParam` sebagai nama variabel. Catatan: Parameter permintaan mendukung bidang sistem untuk ID pengguna yang sedang masuk dan ID organisasi.
Respons API	Konfigurasikan respons yang diharapkan setelah panggilan API berhasil. Mendukung parsing JSON. Catatan: Jika API mengembalikan objek non-JSON, hasilnya tidak dapat langsung digunakan di integrasi & otomatisasi. Anda perlu mem-parsing-nya sendiri pada node skrip.

Langkah 3: Konfigurasikan autentikasi

Setiap konektor kustom harus memiliki skema autentikasi permintaan yang sesuai, termasuk untuk Tanpa autentikasi.

Buat akun

Pada konektor yang telah Terkonfigurasi, klik Uji untuk memilih akun autentikasi. Anda juga dapat menambahkan akun autentikasi baru pada langkah ini.

Masukkan nama tampilan akun, App Key, App Secret, dan informasi lainnya, lalu klik Konfirmasi.

Langkah 4: Uji konektor

Pada halaman detail konektor, klik tombol Uji di sudut kanan atas

Pilih autentikasi yang akan digunakan, lalu konfigurasikan parameter pengujian

Klik Uji. Jika hasil yang diharapkan muncul, konfigurasi berhasil

Memulai

Mulai Cepat

Manajemen Formulir

Desain Alur Kerja

Desain Laporan

Desain Tabel Agregat

Desain Portal

Halaman Kustom

Integrasi & Otomatisasi

Cool App

Manajemen Aplikasi

Manajemen Platform

Internasionalisasi

YiDA Dedicated

Fitur Pengembang

Langkah 1: Buat konektor

Langkah 2: Buat tindakan

Langkah 3: Konfigurasikan autentikasi

Langkah 4: Uji konektor

​Langkah 1: Buat konektor

​Langkah 2: Buat tindakan

​Langkah 3: Konfigurasikan autentikasi

​Langkah 4: Uji konektor

Langkah 1: Buat konektor

Langkah 2: Buat tindakan

Langkah 3: Konfigurasikan autentikasi

Langkah 4: Uji konektor