Saltar al contingut principal
POST
Verifica un Número d’Identificació Nacional (NIN) de Nigèria amb el registre de la National Identity Management Commission. Requereix una selfie: al retrat d’inscripció associat al NIN se li comprova la coincidència facial amb la selfie, i el registre només es retorna quan es tracta de la mateixa persona. Didit exposa aquest servei a través de POST /v3/database-validation/ perquè puguis verificar les dades enviades amb la font autoritzada i rebre resultats de coincidència normalitzats.

Cobertura

  • Cobertura: ~ 100%
  • País: Nigèria
  • ID del servei: nga_national_id_facial
  • Domini de dades: Identitat
  • Categoria: NationalIDRegistry

Entrades

  • Entrades obligatòries: national_id, selfie
  • Entrades opcionals: first_name, last_name, date_of_birth, vendor_data
  • Consentiment: No és necessari
  • Disponibilitat en el flux de treball: Disponible en el flux de treball
  • Cobertura: ~ 100%
  • Preu: $0.35 per consulta satisfactòria
No tots els documents que accepta aquest servei porten l’identificador amb què es fa la consulta. Quan l’identificador no s’extreu del document, la comprovació es registra com a no aplicable: no es consulta cap base de dades i no es cobra. Per a alguns països, això representa una part important dels usuaris reals. Per cobrir-los, recull també l’identificador d’una resposta de Qüestionari, d’un camp d’extracció de Document AI o d’un valor que enviïs en crear la sessió, i mapeja’l al pas de Verificació en bases de dades.

Paràmetres del cos

string
predeterminat:"NGA"
requerit
Codi de país ISO 3166-1 alpha-3 per a aquest servei de base de dades.Exemple: NGA
string
predeterminat:"nga_national_id_facial"
requerit
Matriu que conté l’ID d’aquest servei. Fixar el servei limita la sol·licitud a aquesta base de dades exacta.Exemple: nga_national_id_facial
string
predeterminat:"11111111111"
requerit
Número d’identitat nacional per a aquest servei.Exemple: 11111111111
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
Nom de pila a verificar.Exemple: John
string
Cognom a verificar.Exemple: Doe
string
Data de naixement en format YYYY-MM-DD.Exemple: 1990-01-01
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 la detecció de duplicats.Exemple: user-1234

Regles d’entrada i notes de validació

  • first_name ha de coincidir amb [A-Za-zÀ-ÖØ-öø-ÿ .'-]+.
  • national_id ha de contenir només dígits; elimina els espais, els guions i la puntuació abans d’enviar la sol·licitud.
  • national_id ha de tenir exactament 11 caràcters.

Com fer la crida

Dades retornades

Els camps exactes que apareixen a source_data depenen del que retorni el registre. L’exemple generat per a nga_national_id_facial documenta actualment aquesta estructura normalitzada:
  • address
  • birth_country
  • birth_lga
  • birth_state
  • date_of_birth
  • face_match_score
  • first_name
  • gender
  • identification_number
  • last_name
  • marital_status
  • middle_name
  • phone_number
  • photo_available
  • residence_lga
  • residence_state
  • residence_town

Preus i SLAs

Les consultes de Nigeria National ID + Selfie (NIMC) només es facturen quan Didit rep un resultat concloent de la font de validació.
  • Preu per crida: $0.35 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ípic inferior a 2 s.
  • Disponibilitat: 99.9% per trimestre per part de Didit; la disponibilitat de la font de dades varia segons el país i el conjunt de dades.

Selfie i coincidència facial

El registre de NIMC respon a un NIN vàlid amb el registre complet del titular, de manera que conèixer un número no demostra que n’ets el titular. Per això, cada consulta està vinculada a una selfie: es compara amb la fotografia de registre que NIMC té per a aquest NIN, i el registre només es retorna quan ambdues corresponen a la mateixa persona.
  • Coincidència: source_data conté el registre de NIMC i face_match_score. Els noms i la data de naixement que envies es comparen amb aquest registre, i el resultat s’informa a validation. Envia’ls per obtenir un veredicte sobre el nom i la data de naixement, o omet-los i llegeix els valors del registre a source_data.
  • Persona diferent: BIOMETRIC_NO_MATCH. Només es retorna face_match_score, sense dades personals.
  • Coincidència impossible: INCONCLUSIVE quan NIMC no té cap fotografia per al NIN o no es pot detectar cap rostre. No es retorna res i la comprovació s’envia a revisió.
  • NIN desconegut: DOCUMENT_NOT_FOUND. La consulta es factura.
En un flux de treball, la selfie s’obté del pas de prova de vida o de coincidència facial, o del retrat del document pujat quan el flux no té cap pas facial. Una sol·licitud sense selfie, o amb un NIN que no té 11 dígits, es rebutja abans que es cobri res.

Continua llegint

Darrera modificació el 7 de novembre del 2026