Langsung ke konten utama
POST
Memverifikasi data input dengan sumber resmi milik instansi pemerintah. Didit menyediakan layanan ini melalui POST /v3/database-validation/ agar Anda dapat memverifikasi data yang dikirim dengan sumber otoritatif dan menerima hasil pencocokan yang sudah dinormalisasi.

Cakupan

  • Cakupan: ~ 90%
  • Negara: Indonesia
  • ID layanan: idn_residential_identity_card
  • Domain data: Alamat
  • Kategori: Residensial

Input

  • Input wajib: full_name, date_of_birth, national_id, address.street_1, address.postal_code
  • Input opsional: address.street_2, address.city, address.region, gender, vendor_data
  • Persetujuan: Wajib
  • Ketersediaan dalam alur kerja: Tersedia dalam alur kerja
  • Cakupan: ~ 90%
  • Harga: $0.35 per kueri yang berhasil
Tidak setiap dokumen yang diterima layanan ini memuat pengenal yang digunakan untuk kueri. Jika pengenal tidak diekstrak dari dokumen, pemeriksaan dicatat sebagai tidak berlaku. Dalam kondisi ini tidak ada database yang dikueri dan Anda tidak dikenai biaya. Untuk sebagian negara, kondisi ini mencakup sebagian besar pengguna nyata. Untuk menjangkau mereka, 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:"IDN"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh: IDN
string
default:"idn_residential_identity_card"
wajib
Array yang berisi ID layanan ini. Menetapkan layanan secara tetap memastikan permintaan hanya mengarah ke database yang tepat ini.Contoh: idn_residential_identity_card
Persetujuan eksplisit dari pengguna akhir untuk layanan ini.Contoh: true
string
default:"John Doe"
wajib
Nama lengkap sesuai hukum yang akan divalidasi.Contoh: John Doe
string
default:"1990-01-01"
wajib
Tanggal lahir dalam format YYYY-MM-DD.Contoh: 1990-01-01
string
default:"1111111111111111"
wajib
Nomor identitas nasional untuk layanan ini.Contoh: 1111111111111111
object
wajib
Objek alamat tempat tinggal yang terstruktur. Gunakan street_1, street_2, city, region, postal_code, dan country. String alamat lama yang lengkap masih diterima, tetapi tidak direkomendasikan.Contoh: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
Nilai jenis kelamin, jika database memerlukannya.Nilai yang diizinkan: M (laki-laki), F (perempuan), X (lainnya atau tidak diketahui).Contoh: M
string
default:"user-1234"
Referensi pengguna yang stabil untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan yang berdiri sendiri ke pengguna akhir yang sama dan mengurangi gangguan deteksi duplikasi.Contoh: user-1234

Aturan input & catatan validasi

  • national_id hanya boleh berisi angka; hapus spasi, tanda hubung, dan tanda baca sebelum mengirim permintaan.
  • national_id harus tepat 16 karakter.
  • Untuk layanan berbasis alamat, kirim kolom alamat yang terstruktur, bukan 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, daerah pinggiran kota, kecamatan, 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 pada sumber tidak dikenai biaya.

Cara memanggil

Data yang dikembalikan

Kolom spesifik yang ditampilkan di source_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk idn_residential_identity_card saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • address_match_score
  • date_of_birth
  • identification_number

Harga & SLA

Kueri Kartu Identitas Penduduk Indonesia hanya ditagih ketika Didit menerima hasil yang konklusif dari sumber validasi.
  • Harga per panggilan: $0.35 USD.
  • Penagihan: per kueri yang berhasil. Anda tidak dikenakan biaya ketika registri tidak dapat dijangkau, ketika kolom yang diperlukan 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 kumpulan data.

Lanjut membaca

Terakhir diubah pada 7 November 2026