Langsung ke konten utama
POST
Memverifikasi data input terhadap kartu identitas nasional yang bersumber dari lembaga pemerintah. Didit menyediakan layanan ini melalui POST /v3/database-validation/ sehingga Anda dapat memverifikasi data yang dikirim terhadap sumber otoritatif dan menerima hasil pencocokan yang sudah dinormalisasi. Format input: national_id berisi nomor identitas nasional Thailand: terdiri atas 13 digit, dengan digit terakhir sebagai digit pemeriksa mod-11 (bobot 13 sampai 2 untuk dua belas digit pertama).

Cakupan

  • Cakupan: ~ 90%
  • Negara: Thailand
  • ID layanan: tha_national_id
  • Domain data: Identitas
  • Kategori: NationalIDRegistry

Input

  • Input wajib: first_name, last_name, date_of_birth, national_id
  • Input opsional: 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: ~ 90%
  • Harga: $0.59 per query yang berhasil

Parameter body

string
default:"THA"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh: THA
string
default:"tha_national_id"
wajib
Array yang berisi ID layanan ini. Mengunci layanan membuat permintaan hanya berlaku untuk database yang tepat ini.Contoh: tha_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 belakang yang akan divalidasi.Contoh: Doe
string
default:"1990-01-01"
wajib
Tanggal lahir dalam format YYYY-MM-DD.Contoh: 1990-01-01
string
default:"1111111111111"
wajib
Nomor identitas nasional untuk layanan ini.Contoh: 1111111111111
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
default:"user-1234"
Referensi pengguna tetap Anda untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan yang berdiri sendiri ke pengguna akhir yang sama dan mengurangi gangguan akibat deteksi duplikat.Contoh: user-1234

Aturan input & catatan validasi

  • address bersifat opsional untuk layanan ini. Anda dapat mengirim satu string address lengkap dan Didit akan memecahnya menjadi elemen alamat terstruktur jika memungkinkan, atau Anda dapat mengirim kolom terstruktur secara eksplisit.
  • Nomor identitas nasional Thailand: terdiri atas 13 digit, dengan digit terakhir sebagai digit pemeriksa mod-11 (bobot 13 sampai 2 untuk dua belas digit pertama).
  • national_id hanya boleh berisi digit; hapus spasi, tanda hubung, dan tanda baca sebelum mengirim permintaan.
  • national_id harus tepat 13 karakter.
  • Digit pemeriksa mod-11 pada nomor identitas nasional Thailand divalidasi; nomor yang gagal pemeriksaan ditolak sebelum pencarian dan tidak dikenai biaya.
  • Untuk layanan berbasis alamat, kirim kolom alamat terstruktur alih-alih satu string address jika memungkinkan.
  • address.street_1 adalah alamat jalan, termasuk nomor jalan dan jenis jalan.
  • address.street_2 adalah apartemen, unit, gedung, lantai, atau baris alamat tambahan. Kirim hanya jika Anda memilikinya.
  • address.city adalah kota, daerah pinggiran kota, distrik, lokalitas, 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 di sumber tidak dikenai biaya.

Cara memanggil API

Data yang dikembalikan

Kolom persis yang ditampilkan dalam source_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk tha_national_id saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • address_match_score
  • date_of_birth
  • identification_number
  • name_match_score

Harga & SLA

Kueri kartu identitas nasional Thailand hanya ditagih ketika Didit menerima hasil yang meyakinkan 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 kurang dari 2 detik.
  • Ketersediaan: 99.9% per kuartal di sisi Didit. Ketersediaan sumber hilir bervariasi menurut negara dan dataset.

Lanjut membaca

Terakhir diubah pada 7 November 2026