Langsung ke konten utama
POST
Memverifikasi data input terhadap layanan Swedish Police Authority. Didit menyediakan layanan ini melalui POST /v3/database-validation/ agar Anda dapat memverifikasi data yang dikirim terhadap sumber resmi dan menerima hasil kecocokan yang sudah dinormalisasi.

Cakupan

  • Cakupan: ~ 100%
  • Negara: Swedia
  • ID layanan: swe_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: Tidak diperlukan
  • Ketersediaan dalam alur kerja: Tersedia dalam alur kerja
  • Cakupan: ~ 100%
  • Harga: $0.59 per kueri yang berhasil
Tidak semua dokumen yang diterima layanan ini memuat identifier yang digunakan untuk kueri. Ketika identifier tidak diekstraksi dari dokumen, pemeriksaan dicatat sebagai tidak berlaku: tidak ada database yang dikueri dan Anda tidak dikenai biaya. Untuk beberapa negara, kondisi ini mencakup sebagian besar pengguna sungguhan. Untuk menjangkau mereka, kumpulkan juga identifier 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:"SWE"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh: SWE
string
default:"swe_national_id"
wajib
Array yang berisi ID layanan ini. Mengunci layanan membuat permintaan hanya berlaku untuk database yang tepat ini.Contoh: swe_national_id
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:"199001011234"
wajib
Nomor identitas nasional untuk layanan ini.Contoh: 199001011234
object
Objek alamat tempat tinggal terstruktur. Gunakan street_1, street_2, city, region, postal_code, dan country. String alamat lengkap versi lama 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
default:"user-1234"
Referensi pengguna yang stabil untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan mandiri ke pengguna akhir yang sama dan mengurangi gangguan pada 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 hanya boleh berisi angka; hapus spasi, tanda hubung, dan tanda baca sebelum mengirim permintaan.
  • national_id harus cocok dengan (\d{10}|\d{12}).
  • Untuk layanan berbasis alamat, kirim 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. Kirim hanya jika Anda memilikinya.
  • address.city adalah kota, 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 setidaknya alamat jalan dan kode pos; permintaan yang ditolak sebelum pencarian ke sumber tidak dikenai biaya.

Cara memanggil

Data yang dikembalikan

Kolom yang ditampilkan dalam source_data secara tepat bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk swe_national_id saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • date_of_birth
  • first_name
  • full_name
  • identification_number
  • last_name
  • name_match_score

Harga & SLA

Kueri Nomor Identitas Nasional Swedia hanya ditagih ketika Didit menerima hasil konklusif dari sumber validasi.
  • Harga per panggilan: $0.59 USD.
  • Penagihan: per kueri yang berhasil. Anda tidak dikenakan biaya ketika registri tidak dapat dijangkau, ketika kolom wajib tidak ada, atau ketika permintaan ditolak sebelum mencapai sumber.
  • Latensi: p95 biasanya < 2 dtk.
  • Ketersediaan: 99.9% per kuartal di sisi Didit; ketersediaan sumber hilir bervariasi menurut negara dan dataset.

Lanjutkan membaca

Terakhir diubah pada 7 November 2026