Langsung ke konten utama
POST
Memverifikasi data input terhadap lembaga penerbit resmi Kartu Identitas Finlandia. 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: ~ 100%
  • Negara: Finlandia
  • ID layanan: fin_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 dalam alur kerja: Tersedia dalam alur kerja
  • Cakupan: ~ 100%
  • Harga: $3.50 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 kondisi ini tidak ada database yang dikueri dan Anda tidak dikenai biaya. Untuk beberapa negara, kondisi ini mencakup sebagian besar pengguna nyata. Untuk mencakup pengguna tersebut, kumpulkan juga pengenal tersebut dari jawaban Kuesioner, kolom hasil ekstraksi Document AI, atau nilai yang Anda kirim saat membuat sesi, lalu petakan pada langkah Validasi Database.

Parameter body

string
default:"FIN"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh: FIN
string
default:"fin_national_id"
wajib
Array yang berisi ID layanan ini. Menetapkan layanan membuat permintaan hanya mengarah ke database yang tepat ini.Contoh: fin_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:"010190-123A"
wajib
Nomor identitas nasional untuk layanan ini.Contoh: 010190-123A
object
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 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 Anda yang stabil untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan terpisah ke pengguna akhir yang sama dan mengurangi gangguan 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.
  • national_id harus cocok dengan (?:\d{6}[-+A]\d{3}[0-9A-Z]|\d{6}\d{3}[0-9A-Z]).
  • Untuk layanan berbasis alamat, kirimkan 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. Kirimkan hanya jika Anda memilikinya.
  • address.city adalah kota, 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 sumber tidak dikenai biaya.

Cara memanggil

Data yang dikembalikan

Kolom yang ditampilkan di source_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk fin_national_id saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • address
  • date_of_birth
  • first_name
  • identification_number
  • last_name

Harga & SLA

Kueri ID Nasional Finlandia hanya dikenai penagihan saat Didit menerima hasil yang pasti dari sumber validasi.
  • Harga per panggilan: $3.50 USD.
  • Penagihan: per kueri yang berhasil. Anda tidak dikenai biaya saat registri tidak dapat dijangkau, saat kolom wajib tidak ada, atau saat 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.

Lanjutkan membaca

Terakhir diubah pada 7 November 2026