# Di mana menemukan API key, workflow ID, dan webhook secret?

Source: https://help.didit.me/id/integration/api-key-workflow-id-and-webhook-secret
Updated: 2026-11-12

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](https://docs.didit.me/getting-started/api-authentication) |

> **Note:** 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](https://help.didit.me/id/getting-started/contacting-didit-support). Jika Anda ingin secret baru, rotasi saja: yang lama tetap berfungsi selama 24 jam. Selengkapnya di [mendapatkan hasil verifikasi dengan webhook](https://help.didit.me/id/integration/webhooks-basics).

## Periksa penyiapan Anda

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

2. **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.

3. **Buat sebuah sesi**

   Panggil endpoint create session di `https://verification.didit.me` dengan 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](https://help.didit.me/id/integration/api-errors).

4. **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](https://help.didit.me/id/integration/webhook-troubleshooting).

## Terkait

- [Mengelola API key Anda](https://help.didit.me/id/account-organization/api-keys)
- [Mendapatkan hasil verifikasi dengan webhook](https://help.didit.me/id/integration/webhooks-basics)
- [Membangun workflow verifikasi](https://help.didit.me/id/workflows/build-a-verification-workflow)
- [Autentikasi API](https://docs.didit.me/getting-started/api-authentication) di docs.didit.me