curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_dha_fingerprint_match" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "national_id=SAMPLE-NID-12345" \
-F "right_thumb=RIGHT_THUMB_TEMPLATE" \
-F "left_thumb=LEFT_THUMB_TEMPLATE"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_dha_fingerprint_match",
"service_name": "South Africa - DHA Fingerprint Match",
"source_data": {
"identification_number": "SAMPLE-ID-12345"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_dha_fingerprint_match",
"service_name": "South Africa - DHA Fingerprint Match",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
🇿🇦 Afrika Selatan
Afrika Selatan: API Pencocokan Sidik Jari DHA (ID Match)
Pencocokan sidik jari DHA Afrika Selatan via Didit, database otoritatif. Bayar per panggilan mulai $1.28, tanpa kontrak atau minimum.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_dha_fingerprint_match" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "national_id=SAMPLE-NID-12345" \
-F "right_thumb=RIGHT_THUMB_TEMPLATE" \
-F "left_thumb=LEFT_THUMB_TEMPLATE"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_dha_fingerprint_match",
"service_name": "South Africa - DHA Fingerprint Match",
"source_data": {
"identification_number": "SAMPLE-ID-12345"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_dha_fingerprint_match",
"service_name": "South Africa - DHA Fingerprint Match",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
Memverifikasi gambar sidik jari yang diberikan dengan registri sidik jari Department of Home Affairs. Didit menyediakan layanan ini melalui
POST /v3/database-validation/ agar Anda dapat memverifikasi data yang dikirim dengan sumber resminya dan menerima hasil pencocokan yang sudah dinormalisasi.
Cakupan
- Cakupan: -
- Negara: Afrika Selatan
- ID Layanan:
zaf_dha_fingerprint_match - Domain data: Biometrik
- Kategori: Pemerintah
Input
| Kolom | Wajib | Contoh |
|---|---|---|
national_id | Ya | SAMPLE-NID-12345 |
right_thumb | Ya | RIGHT_THUMB_TEMPLATE |
left_thumb | Ya | LEFT_THUMB_TEMPLATE |
vendor_data | Tidak | user-1234 |
- Input wajib:
national_id,right_thumb,left_thumb - Input opsional:
vendor_data - Persetujuan: Wajib
- Ketersediaan alur kerja: Hanya API mandiri
- Cakupan: -
- Harga: $1.28 per kueri yang berhasil
right_thumb dan left_thumb, yang tidak dihasilkan oleh langkah alur kerja mana pun, sehingga layanan ini hanya tersedia di API mandiri, tempat Anda memasukkan nilainya secara langsung.
Parameter body
string
default:"ZAF"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh:
ZAFstring
default:"zaf_dha_fingerprint_match"
wajib
Array yang berisi ID layanan ini. Mengunci layanan membuat permintaan hanya mengarah ke database yang tepat ini.Contoh:
zaf_dha_fingerprint_matchboolean
default:"true"
wajib
Persetujuan eksplisit dari pengguna akhir untuk layanan ini.Contoh:
truestring
default:"SAMPLE-NID-12345"
wajib
Nomor identitas nasional untuk layanan ini.Contoh:
SAMPLE-NID-12345string
default:"RIGHT_THUMB_TEMPLATE"
wajib
Nilai
right_thumb yang diperlukan oleh layanan database ini.Contoh: RIGHT_THUMB_TEMPLATEstring
default:"LEFT_THUMB_TEMPLATE"
wajib
Nilai
left_thumb yang diperlukan oleh layanan database ini.Contoh: LEFT_THUMB_TEMPLATEstring
default:"user-1234"
Referensi pengguna Anda yang stabil untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan mandiri ke pengguna akhir yang sama dan mengurangi gangguan deteksi duplikat.Contoh:
user-1234Aturan input & catatan validasi
- Kirim kolom yang tercantum di atas persis seperti yang diambil dari pengguna atau dokumen.
- Didit memvalidasi kolom wajib sebelum memanggil database. Permintaan yang ditolak sebelum pencarian ke sumber tidak dikenakan biaya.
Cara memanggilnya
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_dha_fingerprint_match" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "national_id=SAMPLE-NID-12345" \
-F "right_thumb=RIGHT_THUMB_TEMPLATE" \
-F "left_thumb=LEFT_THUMB_TEMPLATE"
Setiap panggilan yang berhasil mengembalikan HTTP 200. Kolom outcome_code memberi tahu Anda apa yang sebenarnya terjadi, misalnya membedakan ketidakcocokan biometrik yang nyata (BIOMETRIC_NO_MATCH) dari swafoto yang tidak dapat dibaca (BIOMETRIC_IMAGE_UNUSABLE). status yang ditampilkan adalah status fitur default; tindakan Partial Match / No Match yang Anda konfigurasi dapat menggantinya.MATCH - Registri mengonfirmasi identitas dan setiap kolom yang diperiksa cocok.{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_dha_fingerprint_match",
"service_name": "South Africa - DHA Fingerprint Match",
"source_data": {
"identification_number": "SAMPLE-ID-12345"
},
"validation": {
"identification_number": "full_match"
}
}
]
}
NO_MATCH - Registri tidak mengembalikan kecocokan untuk data yang dikirim.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "ZAF",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "zaf_dha_fingerprint_match",
"service_name": "South Africa - DHA Fingerprint Match",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
Data yang dikembalikan
Kolom persis yang ditampilkan disource_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk zaf_dha_fingerprint_match saat ini mendokumentasikan bentuk ternormalisasi berikut:
identification_number
Harga & SLA
Kueri DHA Fingerprint Match Afrika Selatan hanya ditagih ketika Didit menerima hasil yang konklusif dari sumber validasi.- Harga per panggilan: $1.28 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 tipikal < 2 dtk.
- 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