Verifica patente di guida Sudafrica - API Didit

​

Copertura

• Copertura: —
• Paese: Sudafrica
• ID servizio: zaf_drivers_license
• Dominio dei dati: Identità
• Categoria: DriverLicence

​

Input

• Input obbligatori: national_id, last_name, initials, licence_number
• Input facoltativi: first_name, date_of_birth, vendor_data
• Consenso: non richiesto
• Disponibilità nel workflow: disponibile nel workflow con mappatura dei campi
• Copertura: —
• Prezzo: $0.80 per query riuscita

​

Parametri del corpo

​

Regole sugli input e note di validazione

• Invia i campi elencati sopra esattamente come sono stati acquisiti dall’utente o dal documento.
• Didit valida i campi obbligatori prima di interrogare il database. Le richieste rifiutate prima della ricerca nella fonte non vengono addebitate.

​

Come effettuare la chiamata

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"

Ogni chiamata riuscita restituisce HTTP 200. Il campo outcome_code indica cosa è effettivamente successo, distinguendo ad esempio una vera mancata corrispondenza biometrica (BIOMETRIC_NO_MATCH) da un selfie non leggibile (BIOMETRIC_IMAGE_UNUSABLE). Lo status mostrato è lo stato predefinito della funzionalità; le azioni configurate per la corrispondenza parziale / la mancata corrispondenza possono sostituirlo.

{
  "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": {}
    }
  ]
}

​

Dati restituiti

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

​

Prezzi e SLA

• Prezzo per chiamata: $0.80 USD.
• Fatturazione: per query riuscita. Non ti viene addebitato nulla quando il registro non è raggiungibile, quando mancano campi obbligatori o quando la richiesta viene rifiutata prima di raggiungere la fonte.
• Latenza: p95 tipico < 2 s.
• Disponibilità: 99.9% per trimestre da parte di Didit; la disponibilità della fonte a valle varia in base al paese e al dataset.

​

Significato di ciascun esito

• MATCH - il registro ha restituito un record della patente per questo numero di patente e i dati inviati corrispondono. source_data contiene il record: identification_number (il numero di patente), first_name e last_name, vehicle_codes (le categorie della patente, ad esempio EB, C1) e expiration_date (la data di scadenza della tessera della patente).
• INCONCLUSIVE - il registro ha accettato la richiesta ma non ha restituito alcun record della patente, quindi non c’era nulla con cui confrontare i dati inviati. source_data.licence_valid è true, validation è vuoto e match_type è null. Non viene confermato alcun aspetto della patente, quindi il controllo viene inviato a revisione, anche quando un altro servizio nella stessa richiesta, come il controllo del documento d’identità nazionale, ha trovato una corrispondenza per la persona, perché questo conferma la persona e non la patente.
• NO_MATCH - il registro ha cercato la patente e l’ha segnalata come non valida (source_data.licence_valid: false). Si applica la tua azione per il caso di mancata corrispondenza.
• REGISTRY_ERROR - il registro non ha eseguito la ricerca, quindi nulla è stato accertato sulla patente. Il controllo viene inviato a revisione e non viene fatturato.

​

Continua a leggere

• Panoramica della Validazione su database per il Sudafrica
• Panoramica della Validazione su database
• Codici di esito