> ## 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. # Konektor HTTP > Pelajari cara membangun Konektor HTTP kustom melalui YiDA Connector Factory untuk mengintegrasikan aplikasi DingTalk, sistem internal, maupun sistem pihak ketiga — mulai dari pembuatan konektor hingga konfigurasi autentikasi. | **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 Masuk ke [YiDA workbench](https://www.yidaapps.com/workPlatform) sebagai Admin. Klik tombol **Manajemen platform** di sudut kanan atas untuk membuka halaman manajemen platform. Klik **Connector Factory** pada menu kiri, klik **Buat konektor**, lalu pilih Konektor HTTP. | **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](https://help.aliyun.com/document_detail/115437.html). | | 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**. 1. Buat akun Pada konektor yang telah Terkonfigurasi, klik Uji untuk memilih akun autentikasi. Anda juga dapat menambahkan akun autentikasi baru pada langkah ini. 2. Masukkan nama tampilan akun, App Key, App Secret, dan informasi lainnya, lalu klik Konfirmasi. ## Langkah 4: Uji konektor