Langsung ke konten utama
POST
Memverifikasi data input terhadap database lembaga pemerintah yang berisi data warga negara Malaysia. Didit menyediakan layanan ini melalui POST /v3/database-validation/ agar Anda dapat memverifikasi data yang dikirim terhadap sumber otoritatif dan menerima hasil kecocokan yang sudah dinormalisasi.

Cakupan

  • Cakupan: > 75%
  • Negara: Malaysia
  • ID layanan: mys_national_id
  • Domain data: Identitas
  • Kategori: NationalIDRegistry

Input

  • Input wajib: full_name, date_of_birth, national_id
  • Input opsional: address.street_1, address.street_2, address.city, address.region, address.postal_code, phone, vendor_data
  • Persetujuan: Wajib
  • Ketersediaan alur kerja: Tersedia dalam alur kerja
  • Cakupan: > 75%
  • Harga: $0.59 per kueri yang berhasil
Tidak setiap dokumen yang diterima layanan ini memuat identifikator yang digunakan untuk kueri. Jika identifikator tidak diekstrak dari dokumen, pemeriksaan dicatat sebagai tidak berlaku: tidak ada database yang dikueri dan Anda tidak dikenai biaya. Untuk beberapa negara, kondisi ini mencakup porsi besar pengguna nyata. Agar tetap tercakup, kumpulkan juga identifikator tersebut dari jawaban Kuesioner, dari kolom hasil ekstraksi Document AI, atau dari nilai yang Anda kirim saat membuat sesi, lalu petakan pada langkah Validasi Database.

Parameter body

string
default:"MYS"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh: MYS
string
default:"mys_national_id"
wajib
Array yang berisi ID layanan ini. Mengunci layanan membuat permintaan hanya mengacu pada database yang tepat ini.Contoh: mys_national_id
Persetujuan eksplisit dari pengguna akhir untuk layanan ini.Contoh: true
string
default:"John Doe"
wajib
Nama resmi lengkap untuk divalidasi.Contoh: John Doe
string
default:"1990-01-01"
wajib
Tanggal lahir dalam format YYYY-MM-DD.Contoh: 1990-01-01
string
default:"111111111111"
wajib
Nomor identitas nasional untuk layanan ini.Contoh: 111111111111
object
Objek alamat tempat tinggal terstruktur. Gunakan street_1, street_2, city, region, postal_code, dan country. String alamat lama yang lengkap 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
Nomor telepon dalam format internasional.Contoh: +15550101000
string
default:"user-1234"
Referensi pengguna tetap Anda untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan terpisah ke pengguna akhir yang sama dan mengurangi gangguan dalam 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 alamat terstruktur secara eksplisit.
  • national_id hanya boleh berisi digit; hapus spasi, tanda hubung, dan tanda baca sebelum mengirim permintaan.
  • national_id harus tepat 12 karakter.
  • Untuk layanan berbasis alamat, kirim kolom alamat terstruktur alih-alih satu string address bila 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, kecamatan, distrik, kelurahan, atau lingkungan.
  • address.region adalah negara bagian, provinsi, wilayah, atau kota.
  • address.postal_code adalah kode pos.
  • Layanan database berbasis alamat memerlukan minimal alamat jalan dan kode pos. Permintaan yang ditolak sebelum pencarian sumber tidak dikenai biaya.

Cara memanggilnya

Data yang dikembalikan

Kolom yang tepat yang ditampilkan di source_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk mys_national_id saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • address
  • address_match_score
  • city
  • date_of_birth
  • identification_number
  • postal_code
  • state
  • street

Harga & SLA

Kueri ID Nasional Malaysia hanya ditagih ketika Didit menerima hasil yang konklusif dari sumber validasi.
  • Harga per panggilan: $0.59 USD.
  • Penagihan: per kueri yang berhasil. Anda tidak dikenai biaya ketika registri tidak dapat dijangkau, ketika kolom wajib tidak ada, 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 set data.

Lanjutkan membaca

Terakhir diubah pada 7 November 2026