API key ada di Pengembang, Kunci API; workflow ID di halaman Workflows; secret penandatanganan webhook ada per endpoint di Pengembang, Webhooks.
Anda memerlukan tiga nilai dari konsol. Kunci API dibuat di Pengembang → Kunci API. ID alur kerja disalin dari halaman Alur kerja. Signing secret webhook milik setiap endpoint di Pengembang → Webhooks, dan Anda dapat menampilkannya lagi kapan saja dengan Tampilkan. Ambil ketiganya dari aplikasi dan lingkungan yang sama, Live atau Sandbox.
Starter app atau proyek buatan AI sering mencantumkan environment variable seperti DIDIT_API_KEY, DIDIT_WORKFLOW_ID, dan DIDIT_WEBHOOK_SECRET. Nama-nama itu milik aplikasi tersebut: Didit tidak mengaturnya untuk Anda. Tabel ini menunjukkan dari mana setiap nilai berasal.
#Di mana setiap nilai berada
| Nilai | Di mana mendapatkannya | Yang perlu diketahui |
|---|---|---|
| Kunci API | Pengembang → Kunci API, lalu Buat kunci (setiap aplikasi juga memiliki kunci Utama) | Secret lengkap hanya ditampilkan sekali, saat Anda membuat atau merotasi kunci, jadi salin ke secret manager Anda saat itu. Aplikasi Live dan aplikasi Sandbox memiliki kunci yang berbeda: sandbox key tidak pernah membuat verifikasi live. Kirim di header x-api-key, hanya dari server Anda |
| ID alur kerja | Verifikasi identitas → Alur kerja: buka menu baris dan pilih Salin ID alur kerja (panel pratinjau memiliki tombol yang sama) | Setiap workflow memiliki ID sendiri di setiap aplikasi. Salinan sebuah workflow mendapat ID baru |
| Signing secret webhook | Pengembang → Webhooks, buka endpoint, lalu signing secret-nya dan tekan Tampilkan | Satu secret per endpoint, bukan per aplikasi. Tampilkan meminta Anda mengonfirmasi bahwa itu Anda, lalu secret tersembunyi lagi dalam 60 detik. Anda dapat menampilkannya lagi kapan pun diperlukan |
| API base URL | Tidak ada di konsol: dinyatakan di docs.didit.me | https://verification.didit.me melayani API verifikasi (sesi, workflow, daftar, webhook), diautentikasi dengan header x-api-key. Lihat autentikasi API |
API key dan signing secret adalah nilai yang berbeda. API key mengautentikasi panggilan Anda ke Didit; signing secret memungkinkan Anda memeriksa bahwa sebuah webhook benar-benar datang dari Didit. Memakai yang satu sebagai pengganti yang lain menghasilkan 401 atau ketidakcocokan tanda tangan.
#Bisakah saya melihat webhook signing secret lagi?
Bisa. Buka Pengembang → Webhooks, buka endpoint, lalu tekan Tampilkan. Konfirmasi bahwa itu Anda, dan secret tampil hingga 60 detik. Jika Tampilkan berwarna abu-abu bagi Anda, minta rekan tim yang memiliki akses atau hubungi support. Jika Anda ingin secret baru, rotasi saja: yang lama tetap berfungsi selama 24 jam. Selengkapnya di mendapatkan hasil verifikasi dengan webhook.
#Periksa penyiapan Anda
- Samakan lingkungan
Pilih dulu aplikasi dan lingkungan Live atau Sandbox di konsol, lalu salin kunci, workflow ID, dan buat endpoint webhook di sana. Sandbox key dengan workflow ID live adalah penyebab umum 401 atau 403.
- Masukkan nilai ke konfigurasi server Anda
Simpan sebagai secret di sisi server. Jangan pernah menaruh API key atau signing secret di kode frontend, repositori publik, atau aplikasi seluler.
- Buat sebuah sesi
Panggil endpoint create session di
https://verification.didit.medengan kunci dan workflow ID Anda. 401 berarti kunci salah, kedaluwarsa, atau dicabut; 403 pada workflow biasanya berarti kunci milik aplikasi yang berbeda. Lihat error API. - Kirim event uji
Di Pengembang → Webhooks, buka endpoint Anda dan tekan Kirim peristiwa uji. Server Anda seharusnya memeriksa tanda tangan dengan signing secret dan menjawab dengan 2xx. Jika tidak ada yang tiba, lihat saat webhook tidak pernah tiba.
#Terkait
- Mengelola API key Anda
- Mendapatkan hasil verifikasi dengan webhook
- Membangun workflow verifikasi
- Autentikasi API di docs.didit.me
Masih buntu? Bicara dengan manusia.
Sertakan ID organisasi Anda dan ID sesi yang Anda tanyakan.