Autentikasi API: Amankan Permintaan API KYC

Menemukan Kunci API Anda

Di Didit, kunci API dibatasi pada Aplikasi tertentu di dalam akun Anda. Aplikasi adalah ruang kerja tempat Anda dapat mengonfigurasi alur kerja dan mengelola verifikasi untuk proyek atau lingkungan tertentu. Setiap Aplikasi mendapatkan kunci API utama dengan akses penuh saat Anda membuatnya. Anda dapat menambahkan kunci lainnya, masing-masing hanya dengan akses yang dibutuhkan oleh layanan atau mitra. Untuk menemukan kunci Anda:

Masuk ke Business Console

Buka Didit Business Console dan masuk.

Pilih Aplikasi Anda

Pilih Aplikasi yang ingin Anda gunakan dari menu dropdown di bagian atas.

Buka Kunci API

Navigasikan ke Developers -> API keys di bilah sisi kiri.

Salin atau buat kunci

Kunci Utama adalah rahasia milik Aplikasi itu sendiri. Buat kunci baru untuk memberi layanan atau mitra rahasianya sendiri, dengan akses yang diperlukannya.

Kunci API Anda adalah Rahasia — perlakukan seperti kata sandi.Kunci utama menyediakan akses penuh ke API atas nama Aplikasi Anda. Jangan pernah mengeksposnya dalam kode frontend, repositori publik, atau bundel sisi klien. Selalu simpan hanya di sisi server.

Format kunci API

Kunci API baru dimulai dengan sk_live_ untuk aplikasi produksi atau sk_test_ untuk aplikasi sandbox, diikuti oleh 43 karakter yang aman untuk URL (huruf, angka, -, dan _). Kunci yang dibuat sebelum format ini tidak memiliki awalan dan tetap berfungsi tanpa perubahan. Kirimkan seluruh kunci, termasuk awalannya, dalam header x-api-key, dan jangan menolak kunci hanya karena tidak memiliki awalan.

Menemukan ID organisasi Anda

ID organisasi Anda adalah UUID yang mengidentifikasi organisasi Anda. Anda menggunakannya di jalur API dengan cakupan organisasi seperti /auth/v2/organizations/me/{org_id}/applications/. Anda dapat menyalinnya langsung dari Business Console, tanpa memerlukan panggilan API:

Buka pengaturan organisasi

Di Didit Business Console, buka Pengaturan Organisasi.

Salin ID organisasi

Kolom ID organisasi menampilkan UUID organisasi Anda di sebelah nama organisasi, dilengkapi tombol salin ke papan klip.

Membuat Permintaan Terautentikasi

Untuk mengautentikasi permintaan API, sertakan kunci API rahasia Anda di header HTTP x-api-key. Berikut adalah contoh permintaan terautentikasi ke endpoint Create Session:

cURL

curl --request POST \
     --url https://verification.didit.me/v3/session/ \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: YOUR_API_KEY' \
     --data '
{
  "workflow_id": "WORKFLOW_ID",
  "vendor_data": "USER_ID",
  "callback": "CALLBACK_URL"
}
'

Penanganan Kesalahan

Jika kunci API Anda salah, formatnya keliru, atau telah dicabut, API akan mengembalikan 401 Unauthorized:

{
  "detail": "Authentication credentials were not provided or are invalid."
}

Kunci yang kedaluwarsa juga mengembalikan 401, dengan "detail": "This API key has expired.". Permintaan tanpa kunci mengembalikan 403 dengan "detail": "You do not have permission to perform this action.".

Kode Status	Arti
401	Kunci API salah, format keliru, dicabut, atau kedaluwarsa
403	Tidak ada kunci API yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan yang diminta, atau permintaan berasal dari alamat di luar daftar IP kunci
403 dengan `"code": "application_deleted"`	Kunci tersebut milik aplikasi yang telah dihapus. API merespons ini selama beberapa menit setelah penghapusan, kemudian menolak kunci seperti kunci tidak valid lainnya. Jangan coba lagi: aplikasi beserta kuncinya sudah tidak ada.
404	Pada rute sesi: sesi berada di luar alur kerja atau status milik kunci tersebut

Halaman Kesalahan API mencantumkan setiap status, isi respons, dan kode.

Kunci API dengan cakupan khusus

Berikan kunci masing-masing untuk setiap layanan atau mitra daripada membagikan kunci utama. Setiap kunci memiliki aksesnya sendiri: tidak ada, baca, atau tulis untuk setiap sumber daya (sesi, keputusan, media, orang, perusahaan, transaksi, alur kerja, webhook, pengaturan aplikasi, analitik), serta batasan opsional pada beberapa alur kerja, hanya pada sesi yang disetujui, pada daftar alamat IP, dan hingga tanggal kedaluwarsa. Anda dapat merotasi kunci dengan masa tumpang tindih 24 jam, dan mencabutnya sekaligus. Kunci yang dibuat sebelum adanya akses dengan cakupan khusus tetap mempertahankan akses penuh. Lihat Kunci API untuk prasetel, sumber daya yang dicakup oleh masing-masing prasetel, dan bagaimana API merespons kunci dengan cakupan khusus.

Jika Anda menerima kesalahan 401, periksa kembali apakah Anda menggunakan kunci API yang benar untuk Aplikasi yang tepat dan pastikan kunci tersebut belum dibuat ulang.

Ikhtisar

Harga

Alur Kerja & Verifikasi

Peninjauan & Operasional

Entitas (Pengguna & Bisnis)

Pengaturan & Kustomisasi

Keamanan & Kepatuhan

Didit Academy

Sumber Daya

Autentikasi API: Amankan Permintaan API KYC

Menemukan Kunci API Anda

Format kunci API

Menemukan ID organisasi Anda

Membuat Permintaan Terautentikasi

Penanganan Kesalahan

Kunci API dengan cakupan khusus

​Menemukan Kunci API Anda

​Format kunci API

​Menemukan ID organisasi Anda

​Membuat Permintaan Terautentikasi

​Penanganan Kesalahan

​Kunci API dengan cakupan khusus

Menemukan Kunci API Anda

Format kunci API

Menemukan ID organisasi Anda

Membuat Permintaan Terautentikasi

Penanganan Kesalahan

Kunci API dengan cakupan khusus