Langsung ke konten utama
POST
Memverifikasi nama, tanggal lahir, dan alamat pemegang DNI / NIE Spanyol terhadap catatan identitas nasional. Didit menyediakan layanan ini melalui POST /v3/database-validation/ agar Anda dapat memverifikasi data yang dikirim terhadap sumber otoritatif dan menerima hasil pencocokan yang dinormalisasi.

Cakupan

  • Cakupan: ~ 75%
  • Negara: Spanyol
  • ID layanan: esp_dni
  • Domain data: Identitas
  • Kategori: NationalIDRegistry

Input

  • Input wajib: first_name, last_name, date_of_birth, address.street_1, address.postal_code
  • Input opsional: national_id, phone, address.street_2, address.city, address.region, vendor_data
  • Persetujuan: Wajib
  • Ketersediaan di alur kerja: Tersedia di alur kerja
  • Cakupan: ~ 75%
  • Harga: $2.10 per kueri yang berhasil

Parameter body

string
default:"ESP"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh: ESP
string
default:"esp_dni"
wajib
Array yang berisi ID layanan ini. Mengunci layanan memastikan permintaan hanya mengarah ke database yang tepat ini.Contoh: esp_dni
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
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 disarankan.Contoh: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
Nomor identitas nasional untuk layanan ini.Contoh: SAMPLE-NID-12345
string
Nomor telepon dalam format internasional.Contoh: +15550101000
string
default:"user-1234"
Referensi pengguna yang stabil dari Anda untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan terpisah ke pengguna akhir yang sama dan mengurangi gangguan akibat deteksi duplikat.Contoh: user-1234

Aturan input & catatan validasi

  • 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, distrik, lokalitas, atau lingkungan.
  • address.region adalah negara bagian, provinsi, wilayah, atau kota kecil.
  • address.postal_code adalah kode pos.
  • Layanan database berbasis alamat memerlukan minimal alamat jalan dan kode pos; permintaan yang ditolak sebelum pencarian sumber tidak dikenakan biaya.

Cara memanggilnya

Data yang dikembalikan

Kolom yang tepat di source_data bergantung pada data yang dikembalikan registri. Contoh yang dihasilkan untuk esp_dni saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • address_match_score
  • date_of_birth
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score

Harga & SLA

Kueri verifikasi DNI/NIE Spanyol hanya ditagih ketika Didit menerima hasil konklusif dari sumber validasi.
  • Harga per panggilan: $2.10 USD.
  • Penagihan: per kueri yang berhasil. Anda tidak dikenai 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 dataset.

Lanjutkan membaca

Terakhir diubah pada 7 November 2026