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"
}
}
]
}
🇿🇦 Sud-àfrica
Coincidència d'empremtes DHA Sud-àfrica: API ID Match
Consulta autoritativa a la base de dades del DHA de Sud-àfrica via Didit. Des de $1.28 per crida, sense contractes ni mínims.
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"
}
}
]
}
Verifica les imatges d’empremtes dactilars proporcionades amb el registre d’empremtes del Department of Home Affairs. Didit ofereix aquest servei a través de
POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font oficial i rebre resultats de coincidència normalitzats.
Cobertura
- Cobertura: -
- País: Sud-àfrica
- ID del servei:
zaf_dha_fingerprint_match - Domini de dades: Biomètric
- Categoria: Govern
Entrades
| Camp | Obligatori | Exemple |
|---|---|---|
national_id | Sí | SAMPLE-NID-12345 |
right_thumb | Sí | RIGHT_THUMB_TEMPLATE |
left_thumb | Sí | LEFT_THUMB_TEMPLATE |
vendor_data | No | user-1234 |
- Entrades obligatòries:
national_id,right_thumb,left_thumb - Entrades opcionals:
vendor_data - Consentiment: Obligatori
- Disponibilitat al flux de treball: Només API autònoma
- Cobertura: -
- Preu: $1.28 per consulta satisfactòria
right_thumb i left_thumb, que no són valors que produeixi un pas del flux de treball, de manera que només està disponible a l’API autònoma, on proporciones els valors directament.
Paràmetres del cos
string
predeterminat:"ZAF"
requerit
Codi de país ISO 3166-1 alfa-3 per a aquest servei de bases de dades.Exemple:
ZAFstring
predeterminat:"zaf_dha_fingerprint_match"
requerit
Matriu que conté l’ID d’aquest servei. Fixar el servei manté la sol·licitud limitada a aquesta base de dades exacta.Exemple:
zaf_dha_fingerprint_matchboolean
predeterminat:"true"
requerit
Consentiment explícit de l’usuari final per a aquest servei.Exemple:
truestring
predeterminat:"SAMPLE-NID-12345"
requerit
Número d’identitat nacional per a aquest servei.Exemple:
SAMPLE-NID-12345string
predeterminat:"RIGHT_THUMB_TEMPLATE"
requerit
Valor de
right_thumb que requereix aquest servei de bases de dades.Exemple: RIGHT_THUMB_TEMPLATEstring
predeterminat:"LEFT_THUMB_TEMPLATE"
requerit
Valor de
left_thumb que requereix aquest servei de bases de dades.Exemple: LEFT_THUMB_TEMPLATEstring
predeterminat:"user-1234"
La teva referència estable d’usuari per a aquesta persona, com ara el teu ID d’usuari intern. Didit l’utilitza per vincular les comprovacions autònomes amb el mateix usuari final i reduir el soroll de detecció de duplicats.Exemple:
user-1234Regles d’entrada i notes de validació
- Envia els camps indicats més amunt exactament tal com s’han capturat de l’usuari o del document.
- Didit valida els camps obligatoris abans de consultar la base de dades. Les sol·licituds rebutjades abans de la consulta a la font no es cobren.
Com fer la crida
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"
Cada crida satisfactòria retorna HTTP 200. El camp outcome_code indica què ha passat realment, distingint, per exemple, una discordança biomètrica real (BIOMETRIC_NO_MATCH) d’una selfie que no s’ha pogut llegir (BIOMETRIC_IMAGE_UNUSABLE). L’status que es mostra és l’estat per defecte de la funcionalitat; les teves accions configurades de Coincidència parcial / Sense coincidència poden substituir-lo.MATCH: El registre ha confirmat la identitat i tots els camps verificats han coincidit.{
"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: El registre no ha retornat cap coincidència per a les dades enviades.{
"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"
}
}
]
}
Dades retornades
Els camps exactes que apareixen asource_data depenen del que retorni el registre. L’exemple generat per a zaf_dha_fingerprint_match documenta actualment aquesta estructura normalitzada:
identification_number
Preus i SLA
Les consultes de DHA Fingerprint Match de Sud-àfrica només es facturen quan Didit rep un resultat concloent de la font de validació.- Preu per crida: $1.28 USD.
- Facturació: per consulta satisfactòria. No se’t cobra quan el registre no és accessible, quan falten camps obligatoris o quan la sol·licitud es rebutja abans d’arribar a la font.
- Latència: p95 típica < 2 s.
- Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font dependent varia segons el país i el conjunt de dades.
Continua llegint
Darrera modificació el 7 de novembre del 2026