Langsung ke konten utama
POST
Mengambil foto yang terdaftar di Department of Home Affairs untuk nomor identitas Afrika Selatan. Didit menyediakan layanan ini melalui POST /v3/database-validation/ sehingga Anda dapat memverifikasi data yang dikirim terhadap sumber resmi dan menerima hasil pencocokan yang sudah dinormalisasi.

Cakupan

  • Cakupan: —
  • Negara: Afrika Selatan
  • ID layanan: zaf_dha_photo
  • Domain data: Biometrik
  • Kategori: Pemerintah

Input

  • Input wajib: national_id
  • Input opsional: vendor_data
  • Persetujuan: Wajib
  • Ketersediaan alur kerja: Tersedia di alur kerja
  • Cakupan: —
  • Harga: $1.34 per kueri yang berhasil

Parameter body

string
default:"ZAF"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan basis data ini.Contoh: ZAF
string
default:"zaf_dha_photo"
wajib
Array yang berisi ID layanan ini. Menetapkan layanan ini memastikan permintaan tetap terbatas pada basis data yang spesifik ini.Contoh: zaf_dha_photo
Persetujuan eksplisit dari pengguna akhir untuk layanan ini.Contoh: true
string
default:"SAMPLE-NID-12345"
wajib
Nomor identitas nasional untuk layanan ini.Contoh: SAMPLE-NID-12345
string
default:"user-1234"
Referensi pengguna tetap Anda 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

  • Kirim kolom yang tercantum di atas persis seperti yang diambil dari pengguna atau dokumen.
  • Didit memvalidasi kolom wajib sebelum memanggil basis data. Permintaan yang ditolak sebelum pencarian ke sumber tidak dikenai biaya.

Cara memanggilnya

Data yang dikembalikan

Kolom yang tepat di source_data bergantung pada apa yang dikembalikan registri. Contoh yang dibuat untuk zaf_dha_photo saat ini mendokumentasikan bentuk ternormalisasi berikut:
  • birth_place_country_code
  • deceased
  • first_name
  • id_blocked
  • identification_number
  • last_name
  • marital_status
  • on_hanis_biometric_register
  • on_national_population_register
  • photo_base64
  • smart_card_issued
  • transaction_number

Harga & SLA

Kueri Pengambilan Foto DHA Afrika Selatan hanya ditagihkan ketika Didit menerima hasil yang konklusif dari sumber validasi.
  • Harga per panggilan: $1.34 USD.
  • Penagihan: per kueri yang berhasil. Anda tidak dikenai biaya ketika registri tidak dapat dijangkau, ketika kolom wajib tidak ada, atau ketika permintaan ditolak sebelum mencapai sumber.
  • Latensi: p95 tipikal < 2 detik.
  • Ketersediaan: 99.9% per kuartal di sisi Didit; ketersediaan sumber hilir bervariasi menurut negara dan dataset.

Lanjutkan membaca

Terakhir diubah pada 7 November 2026