Saltar al contingut principal
POST
Cribra una imatge facial contra conjunts de dades publicats de registres criminals per detectar possibles coincidències. Didit ofereix aquest servei a través de POST /v3/database-validation/ perquè puguis verificar les dades enviades contra la font autoritzada i rebre resultats de coincidència normalitzats.

Cobertura

  • Cobertura: —
  • País: Sud-àfrica
  • ID del servei: zaf_criminal_face_screening
  • Àmbit de dades: Criminal
  • Categoria: Criminal

Entrades

  • Entrades obligatòries: selfie
  • Entrades opcionals: score_level, max_matches, vendor_data
  • Consentiment: Obligatori
  • Disponibilitat al flux de treball: Disponible al flux de treball
  • Cobertura: —
  • Preu: $8.00 per consulta satisfactòria

Paràmetres del cos

string
predeterminat:"ZAF"
requerit
Codi de país ISO 3166-1 alpha-3 per a aquest servei de base de dades.Exemple: ZAF
string
predeterminat:"zaf_criminal_face_screening"
requerit
Matriu que conté aquest ID de servei. Fixar el servei limita la sol·licitud a aquesta base de dades exacta.Exemple: zaf_criminal_face_screening
Consentiment explícit de l’usuari final per a aquest servei.Exemple: true
file
requerit
Fitxer d’imatge de selfie que cal carregar per a la validació biomètrica en bases de dades. Formats acceptats: JPEG, PNG o WebP.Exemple: @./selfie.jpg
string
Valor de score_level requerit per aquest servei de base de dades.Exemple: standard
string
Valor de max_matches requerit per aquest servei de base de dades.Exemple: 10
string
predeterminat:"user-1234"
La teva referència estable d’usuari per a aquesta persona, com ara el teu ID intern d’usuari. Didit l’utilitza per vincular les comprovacions independents al mateix usuari final i reduir el soroll de detecció de duplicats.Exemple: user-1234

Regles 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 facturen.

Com fer la crida

Dades retornades

Els camps exactes exposats a source_data depenen del que retorni el registre. L’exemple generat per a zaf_criminal_face_screening documenta actualment aquesta estructura normalitzada:
  • criminal_matches
  • face_quality
  • request_id

Preus i SLA

Les consultes de cribratge facial de registres criminals de Sud-àfrica només es facturen quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $8.00 USD.
  • Facturació: per consulta satisfactòria. No se’t factura quan el registre és inaccessible, 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 les fonts subjacents varia segons el país i el conjunt de dades.

Continua llegint

Darrera modificació el 7 de novembre del 2026