Langsung ke konten utama
POST
Memverifikasi Nomor Identitas Nasional (NIN) Nigeria terhadap registri National Identity Management Commission. Diperlukan swafoto: foto pendaftaran yang tersimpan bersama NIN dicocokkan dengan wajah dalam swafoto, dan catatan hanya dikembalikan jika keduanya merupakan orang yang sama. Didit menyediakan layanan ini melalui POST /v3/database-validation/ sehingga Anda dapat memverifikasi data yang dikirim terhadap sumber otoritatif dan menerima hasil pencocokan yang ternormalisasi.

Cakupan

  • Cakupan: ~ 100%
  • Negara: Nigeria
  • ID layanan: nga_national_id_facial
  • Domain data: Identitas
  • Kategori: NationalIDRegistry

Input

  • Input wajib: national_id, selfie
  • Input opsional: first_name, last_name, date_of_birth, vendor_data
  • Persetujuan: Tidak diperlukan
  • Ketersediaan dalam alur kerja: Tersedia dalam alur kerja
  • Cakupan: ~ 100%
  • 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: tidak ada database yang dikueri dan Anda tidak dikenai biaya. Untuk beberapa negara, kondisi ini mencakup porsi besar pengguna sungguhan. Untuk menjangkau mereka, 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:"NGA"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh: NGA
string
default:"nga_national_id_facial"
wajib
Array yang berisi ID layanan ini. Mengunci layanan memastikan permintaan hanya berlaku untuk database yang tepat ini.Contoh: nga_national_id_facial
string
default:"11111111111"
wajib
Nomor identitas nasional untuk layanan ini.Contoh: 11111111111
file
wajib
File gambar swafoto yang diunggah untuk validasi database biometrik. Format yang diterima: JPEG, PNG, atau WebP.Contoh: @./selfie.jpg
string
Nama depan yang akan divalidasi.Contoh: John
string
Nama keluarga yang akan divalidasi.Contoh: Doe
string
Tanggal lahir dalam format YYYY-MM-DD.Contoh: 1990-01-01
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 dalam deteksi duplikat.Contoh: user-1234

Aturan input & catatan validasi

  • first_name harus cocok dengan [A-Za-zÀ-ÖØ-öø-ÿ .'-]+.
  • national_id hanya boleh berisi angka; hapus spasi, tanda hubung, dan tanda baca sebelum mengirim permintaan.
  • national_id harus tepat 11 karakter.

Cara memanggilnya

Data yang dikembalikan

Kolom yang ditampilkan di source_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk nga_national_id_facial saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • address
  • birth_country
  • birth_lga
  • birth_state
  • date_of_birth
  • face_match_score
  • first_name
  • gender
  • identification_number
  • last_name
  • marital_status
  • middle_name
  • phone_number
  • photo_available
  • residence_lga
  • residence_state
  • residence_town

Harga & SLA

Kueri Nigeria National ID + Selfie (NIMC) hanya ditagih ketika Didit menerima hasil konklusif dari sumber validasi.
  • Harga per panggilan: $0.35 USD.
  • Penagihan: per kueri yang berhasil. Anda tidak dikenai biaya ketika registri tidak dapat dijangkau, ketika kolom wajib tidak diisi, 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.

Swafoto dan pencocokan wajah

Registri NIMC merespons NIN yang valid dengan catatan lengkap pemegangnya, sehingga mengetahui sebuah nomor tidak membuktikan bahwa seseorang adalah pemiliknya. Oleh karena itu, setiap pencarian dikaitkan dengan swafoto: swafoto dicocokkan dengan foto pendaftaran yang dimiliki NIMC untuk NIN tersebut, dan catatan hanya dikembalikan jika keduanya berasal dari orang yang sama.
  • Cocok: source_data memuat catatan NIMC dan face_match_score. Nama dan tanggal lahir yang Anda kirim dibandingkan dengan data tersebut dan dilaporkan di validation. Kirimkan keduanya untuk mendapatkan putusan nama dan tanggal lahir, atau hilangkan dan baca nilai registri dari source_data.
  • Orang berbeda: BIOMETRIC_NO_MATCH. Hanya face_match_score yang dikembalikan, tanpa data pribadi.
  • Pencocokan tidak memungkinkan: INCONCLUSIVE ketika NIMC tidak memiliki foto untuk NIN tersebut atau tidak ada wajah yang dapat ditemukan. Tidak ada yang dikembalikan, dan pemeriksaan dikirim untuk ditinjau.
  • NIN tidak dikenal: DOCUMENT_NOT_FOUND. Pencarian tetap ditagih.
Dalam alur kerja, swafoto diambil dari langkah Deteksi Liveness atau pencocokan wajah, atau dari potret pada dokumen yang diunggah ketika alur kerja tidak memiliki langkah yang menggunakan wajah. Permintaan tanpa swafoto, atau dengan NIN yang bukan 11 digit, ditolak sebelum ada yang ditagih.

Lanjut membaca

Terakhir diubah pada 7 November 2026