curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=ZAF" \
-F "services=zaf_vehicle_ownership" \
-F "vendor_data=user-1234" \
-F "national_id=SAMPLE-NID-12345" \
-F "vehicle_register_number=VRN123456" \
-F "vehicle_licence_plate=ABC123GP" \
-F "vin=1HGCM82633A004352"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"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_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
🇿🇦 Afrika Selatan
Verifikasi Kepemilikan Kendaraan Afrika Selatan API
Validasi kepemilikan kendaraan Afrika Selatan lewat database resmi melalui Didit. Mulai dari $3.36 per panggilan, tanpa kontrak, tanpa 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_vehicle_ownership" \
-F "vendor_data=user-1234" \
-F "national_id=SAMPLE-NID-12345" \
-F "vehicle_register_number=VRN123456" \
-F "vehicle_licence_plate=ABC123GP" \
-F "vin=1HGCM82633A004352"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "ZAF",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "zaf_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"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_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
Memastikan bahwa individu Afrika Selatan adalah pemilik terdaftar dari kendaraan tertentu melalui registri kendaraan NATIS. Didit menyediakan layanan ini melalui
POST /v3/database-validation/ agar Anda dapat memverifikasi data yang dikirim terhadap sumber resmi dan menerima hasil pencocokan yang sudah dinormalisasi.
Cakupan
- Cakupan: -
- Negara: Afrika Selatan
- ID layanan:
zaf_vehicle_ownership - Domain data: Pemerintah
- Kategori: Lainnya
Input
| Kolom | Wajib | Contoh |
|---|---|---|
national_id | Ya | SAMPLE-NID-12345 |
vehicle_register_number | Ya | VRN123456 |
vehicle_licence_plate | Ya | ABC123GP |
vin | Ya | 1HGCM82633A004352 |
vendor_data | Tidak | user-1234 |
- Input wajib:
national_id,vehicle_register_number,vehicle_licence_plate,vin - Input opsional:
vendor_data - Persetujuan: Tidak diperlukan
- Ketersediaan di alur kerja: Tersedia di alur kerja dengan pemetaan kolom
- Cakupan: -
- Harga: $3.36 per kueri yang berhasil
vehicle_register_number, vehicle_licence_plate dan vin tidak tercetak pada dokumen identitas, sehingga tidak ada langkah yang menghasilkannya sendiri. Kumpulkan nilai tersebut dari jawaban Kuesioner, dari kolom hasil ekstraksi Document AI, atau dari nilai yang Anda kirim saat membuat sesi, lalu petakan masing-masing pada langkah Validasi Database. Sebelum dipetakan, editor alur kerja menampilkan layanan ini sebagai nonaktif dan menyebutkan input yang belum ada. Saat dijalankan, input yang hilang berarti pemeriksaan dilewati sebelum kueri apa pun, sehingga Anda tidak pernah ditagih untuk database yang tidak dapat dipanggil.
Parameter body
string
default:"ZAF"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh:
ZAFstring
default:"zaf_vehicle_ownership"
wajib
Array yang berisi ID layanan ini. Mengunci layanan membuat permintaan hanya mengarah ke database yang tepat ini.Contoh:
zaf_vehicle_ownershipstring
default:"SAMPLE-NID-12345"
wajib
Nomor identitas nasional untuk layanan ini.Contoh:
SAMPLE-NID-12345string
default:"VRN123456"
wajib
Nilai
vehicle_register_number yang diwajibkan oleh layanan database ini.Contoh: VRN123456string
default:"ABC123GP"
wajib
Nilai
vehicle_licence_plate yang diwajibkan oleh layanan database ini.Contoh: ABC123GPstring
default:"1HGCM82633A004352"
wajib
Nilai
vin yang diwajibkan oleh layanan database ini.Contoh: 1HGCM82633A004352string
default:"user-1234"
Referensi pengguna tetap Anda untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menghubungkan pemeriksaan terpisah ke pengguna akhir yang sama dan mengurangi derau deteksi duplikat.Contoh:
user-1234Aturan input & catatan validasi
- Kirim kolom yang tercantum di atas persis seperti yang dikumpulkan dari pengguna atau dokumen.
- Didit memvalidasi kolom wajib sebelum memanggil database. Permintaan yang ditolak sebelum pencarian ke sumber tidak ditagih.
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_vehicle_ownership" \
-F "vendor_data=user-1234" \
-F "national_id=SAMPLE-NID-12345" \
-F "vehicle_register_number=VRN123456" \
-F "vehicle_licence_plate=ABC123GP" \
-F "vin=1HGCM82633A004352"
Setiap panggilan yang berhasil mengembalikan HTTP 200. Kolom outcome_code menunjukkan apa yang sebenarnya terjadi, misalnya membedakan ketidakcocokan biometrik yang sebenarnya (BIOMETRIC_NO_MATCH) dari swafoto yang tidak dapat dibaca (BIOMETRIC_IMAGE_UNUSABLE). status yang ditampilkan adalah status fitur default. Tindakan kecocokan sebagian / tidak cocok yang Anda konfigurasi dapat menggantinya.MATCH: Registri mengonfirmasi identitasnya 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_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"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_vehicle_ownership",
"service_name": "South Africa - Vehicle Ownership Verification",
"source_data": {
"identification_number": "NO_MATCH"
},
"validation": {
"identification_number": "no_match"
}
}
]
}
Data yang dikembalikan
Kolom yang tepat yang ditampilkan dalamsource_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk zaf_vehicle_ownership saat ini mendokumentasikan bentuk ternormalisasi berikut:
identification_number
Harga & SLA
Kueri Verifikasi Kepemilikan Kendaraan di Afrika Selatan hanya ditagih saat Didit menerima hasil yang meyakinkan dari sumber validasi.- Harga per panggilan: $3.36 USD.
- Penagihan: per kueri yang berhasil. Anda tidak ditagih saat registri tidak dapat dijangkau, saat kolom wajib belum ada, atau saat permintaan ditolak sebelum mencapai sumber.
- Latensi: p95 tipikal di bawah 2 detik.
- 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