Langsung ke konten utama
POST
Memverifikasi data input terhadap basis data instansi pemerintah yang berisi data identitas nasional warga negara. Didit menyediakan layanan ini melalui POST /v3/database-validation/ sehingga Anda dapat memverifikasi data yang dikirim terhadap sumber resmi dan menerima hasil kecocokan yang sudah dinormalisasi.

Cakupan

  • Cakupan: ~ 80%
  • Negara: Kamboja
  • ID layanan: khm_national_id
  • Domain data: Identitas
  • Kategori: NationalIDRegistry

Input

  • Input wajib: first_name, last_name, date_of_birth, voter_id
  • Input opsional: gender, address.street_1, address.street_2, address.city, address.region, address.postal_code, vendor_data
  • Persetujuan: Wajib
  • Ketersediaan alur kerja: Tersedia dalam alur kerja
  • Cakupan: ~ 80%
  • Harga: $0.59 per kueri yang berhasil
Tidak setiap dokumen yang diterima layanan ini memuat pengenal yang digunakan untuk kueri. Jika pengenal tidak diekstraksi dari dokumen, pemeriksaan dicatat sebagai tidak berlaku. Dalam kasus ini, tidak ada basis data yang dikueri dan Anda tidak dikenakan biaya. Untuk beberapa negara, kondisi ini mencakup porsi pengguna nyata yang besar. Untuk menjangkaunya, kumpulkan juga pengenal tersebut dari jawaban Kuesioner, kolom ekstraksi Document AI, atau nilai yang Anda kirim saat membuat sesi, lalu petakan pada langkah Validasi Database.

Parameter body

string
default:"KHM"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan basis data ini.Contoh: KHM
string
default:"khm_national_id"
wajib
Array yang berisi ID layanan ini. Menetapkan layanan menjaga permintaan tetap terbatas pada basis data yang tepat ini.Contoh: khm_national_id
Persetujuan eksplisit dari pengguna akhir untuk layanan ini.Contoh: true
string
default:"John"
wajib
Nama depan yang akan divalidasi.Contoh: John
string
default:"Doe"
wajib
Nama keluarga yang akan divalidasi.Contoh: Doe
string
default:"1990-01-01"
wajib
Tanggal lahir dalam format YYYY-MM-DD.Contoh: 1990-01-01
string
default:"12345678"
wajib
Pengenal pemilih.Contoh: 12345678
string
Nilai jenis kelamin, jika diwajibkan oleh basis data.Nilai yang diizinkan: M (laki-laki), F (perempuan), X (lainnya atau tidak diketahui).Contoh: M
object
Objek alamat tempat tinggal terstruktur. Gunakan street_1, street_2, city, region, postal_code, dan country. String alamat lengkap versi lama masih diterima, tetapi tidak disarankan.Contoh: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
default:"user-1234"
Referensi pengguna yang stabil untuk orang ini di sistem Anda, misalnya ID pengguna internal. Didit menggunakannya untuk menautkan pemeriksaan terpisah ke pengguna akhir yang sama dan mengurangi gangguan dari deteksi duplikat.Contoh: user-1234

Aturan input & catatan validasi

  • address bersifat opsional untuk layanan ini. Anda dapat mengirim satu string address yang lengkap dan Didit akan memecahnya menjadi elemen alamat terstruktur jika memungkinkan, atau Anda dapat mengirim kolom terstruktur secara eksplisit.
  • voter_id harus cocok dengan (?:\d{8,9}|\d{2}-\d{3}-\d{3}).
  • Untuk layanan berbasis alamat, kirim kolom alamat terstruktur alih-alih satu string address jika memungkinkan.
  • address.street_1 adalah alamat jalan, termasuk nomor dan jenis jalan.
  • address.street_2 adalah apartemen, unit, gedung, lantai, atau baris alamat tambahan. Kirim hanya jika Anda memilikinya.
  • address.city adalah kota, pinggiran kota, distrik, lokalitas, atau lingkungan.
  • address.region adalah negara bagian, provinsi, wilayah, atau kota kecil.
  • address.postal_code adalah kode pos.
  • Layanan basis data berbasis alamat memerlukan setidaknya alamat jalan dan kode pos. Permintaan yang ditolak sebelum pencarian sumber tidak dikenakan biaya.

Cara memanggil API

Data yang dikembalikan

Kolom persis yang ditampilkan di source_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk khm_national_id saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • address
  • address_match_score
  • building_number
  • city
  • date_of_birth
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score
  • state
  • street

Harga & SLA

Kueri kartu identitas nasional Kamboja hanya ditagih ketika Didit menerima hasil yang konklusif dari sumber validasi.
  • Harga per panggilan: $0.59 USD.
  • Penagihan: per kueri yang berhasil. Anda tidak dikenakan biaya ketika registri tidak dapat dijangkau, ketika kolom wajib hilang, atau ketika permintaan ditolak sebelum mencapai sumber.
  • Latensi: p95 tipikal < 2 s.
  • Ketersediaan: 99.9% per kuartal di sisi Didit; ketersediaan sumber hilir bervariasi menurut negara dan dataset.

Lanjut membaca

Terakhir diubah pada 7 November 2026