Verificació del permís de conduir a Sud-àfrica (API)

​

Cobertura

• Cobertura: —
• País: Sud-àfrica
• ID del servei: zaf_drivers_license
• Domini de dades: Identitat
• Categoria: DriverLicence

​

Entrades

• Entrades obligatòries: national_id, last_name, initials, licence_number
• Entrades opcionals: first_name, date_of_birth, vendor_data
• Consentiment: No requerit
• Disponibilitat al flux de treball: Disponible al flux de treball amb mapatge de camps
• Cobertura: —
• Preu: $0.80 per consulta satisfactòria

​

Paràmetres del cos

​

Regles d’entrada i notes de validació

• Envia els camps indicats anteriorment exactament tal com els ha capturat l’usuari o el document.
• Didit valida els camps obligatoris abans de cridar 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_drivers_license" \
  -F "vendor_data=user-1234" \
  -F "national_id=SAMPLE-NID-12345" \
  -F "last_name=Doe" \
  -F "initials=JD" \
  -F "licence_number=LIC123456"

Totes les crides satisfactòries retornen HTTP 200. El camp outcome_code indica què ha passat realment, distingint, per exemple, una discrepància biomètrica real (BIOMETRIC_NO_MATCH) d’una selfie que no s’ha pogut llegir (BIOMETRIC_IMAGE_UNUSABLE). L’status mostrat és l’estat per defecte de la funcionalitat; les accions configurades per a coincidència parcial i sense coincidència poden substituir-lo.

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_drivers_license",
      "service_name": "South Africa - Driving License Verification",
      "source_data": {
        "expiration_date": "2030-05-31",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "vehicle_codes": "EB"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": null,
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_drivers_license",
      "service_name": "South Africa - Driving License Verification",
      "source_data": {
        "licence_valid": false
      },
      "validation": {}
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "ZAF",
  "match_type": null,
  "validations": [
    {
      "outcome_code": "INCONCLUSIVE",
      "service_id": "zaf_drivers_license",
      "service_name": "South Africa - Driving License Verification",
      "source_data": {
        "licence_valid": true
      },
      "validation": {}
    }
  ]
}

​

Dades retornades

• expiration_date
• first_name
• identification_number
• last_name
• licence_valid
• vehicle_codes

​

Preus i SLA

• Preu per crida: $0.80 USD.
• Facturació: per consulta satisfactòria. No es 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ípic < 2 s.
• Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font varia segons el país i el conjunt de dades.

​

Què significa cada resultat

• MATCH - el registre ha retornat un registre de llicència per a aquest número de llicència, i les dades que heu enviat hi coincideixen. source_data conté el registre: identification_number (el número de llicència), first_name i last_name, vehicle_codes (les classes de llicència, p. ex. EB, C1) i expiration_date (la data de caducitat del carnet de conduir).
• INCONCLUSIVE - el registre ha acceptat la consulta però no ha retornat cap registre de llicència, de manera que no hi havia res amb què comparar les dades enviades. source_data.licence_valid és true, validation és buit i match_type és null. No es confirma res sobre la llicència, així que la comprovació s’envia a revisió, també quan un altre servei de la mateixa sol·licitud, com la comprovació del document d’identitat nacional, ha coincidit amb la persona, perquè això confirma la persona i no la llicència.
• NO_MATCH - el registre ha buscat la llicència i ha informat que no és vàlida (source_data.licence_valid: false). S’aplica la vostra acció per a no coincidències.
• REGISTRY_ERROR - el registre no ha dut a terme la cerca, de manera que no s’ha establert res sobre la llicència. La comprovació s’envia a revisió i no es factura.

​

Continua llegint

• Visió general de la validació en bases de dades a Sud-àfrica
• Visió general de la validació en bases de dades
• Codis de resultat