Zum Hauptinhalt springen
POST
Überprüft eine nigerianische National Identification Number (NIN) im Register der National Identity Management Commission. Ein Selfie ist erforderlich: Das Registrierungsfoto, das zur NIN hinterlegt ist, wird per Gesichtsabgleich mit dem Selfie verglichen, und der Datensatz wird nur zurückgegeben, wenn es sich um dieselbe Person handelt. Didit stellt diesen Dienst über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Abgleichsergebnisse erhalten.

Abdeckung

  • Abdeckung: ~ 100%
  • Land: Nigeria
  • Service-ID: nga_national_id_facial
  • Datenbereich: Identität
  • Kategorie: NationalIDRegistry

Eingaben

  • Pflichteingaben: national_id, selfie
  • Optionale Eingaben: first_name, last_name, date_of_birth, vendor_data
  • Einwilligung: Nicht erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: ~ 100%
  • Preis: $0.35 pro erfolgreiche Abfrage
Nicht jedes Dokument, das dieser Dienst akzeptiert, enthält die Kennung, über die abgefragt wird. Wenn die Kennung nicht aus dem Dokument extrahiert wird, wird die Prüfung als nicht zutreffend erfasst: Es wird keine Datenbank abgefragt, und Ihnen wird nichts berechnet. In einigen Ländern betrifft das einen großen Anteil der realen Nutzer. Erfassen Sie die Kennung deshalb zusätzlich über eine Antwort im Fragebogen, ein Feld der Document-AI-Extraktion oder einen Wert, den Sie beim Erstellen der Sitzung übermitteln, und ordnen Sie sie im Schritt Datenbankvalidierung zu.

Body-Parameter

string
Standard:"NGA"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: NGA
string
Standard:"nga_national_id_facial"
erforderlich
Array mit dieser Service-ID. Durch die Angabe des Dienstes bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: nga_national_id_facial
string
Standard:"11111111111"
erforderlich
Nationale Identifikationsnummer für diesen Dienst.Beispiel: 11111111111
file
erforderlich
Selfie-Bilddatei, die für die biometrische Datenbankvalidierung hochgeladen wird. Akzeptierte Formate: JPEG, PNG oder WebP.Beispiel: @./selfie.jpg
string
Zu validierender Vorname.Beispiel: John
string
Zu validierender Nachname.Beispiel: Doe
string
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
string
Standard:"user-1234"
Ihre stabile Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und das Rauschen bei der Duplikaterkennung zu reduzieren.Beispiel: user-1234

Eingaberegeln & Validierungshinweise

  • first_name muss dem Muster [A-Za-zÀ-ÖØ-öø-ÿ .'-]+ entsprechen.
  • national_id darf nur Ziffern enthalten. Entfernen Sie vor dem Senden der Anfrage Leerzeichen, Bindestriche und Satzzeichen.
  • national_id muss genau 11 Zeichen lang sein.

So rufen Sie es auf

Rückgabedaten

Welche Felder genau in source_data erscheinen, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für nga_national_id_facial dokumentiert derzeit diese normalisierte Struktur:
  • 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

Preise & SLAs

Abfragen für die Nigeria National ID + Selfie (NIMC) werden nur berechnet, wenn Didit von der Validierungsquelle ein eindeutiges Ergebnis erhält.
  • Preis pro Aufruf: $0.35 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Sie zahlen nicht, wenn das Register nicht erreichbar ist, wenn Pflichtfelder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
  • Latenz: typischer p95-Wert unter 2 s.
  • Verfügbarkeit: 99.9% pro Quartal seitens Didit. Die Verfügbarkeit der nachgelagerten Quellen hängt vom Land und vom Datensatz ab.

Selfie und Gesichtsabgleich

Das NIMC-Register beantwortet eine gültige NIN mit dem vollständigen Datensatz des Inhabers. Die Kenntnis einer Nummer ist daher kein Nachweis, dass man der Inhaber dieser NIN ist. Jede Abfrage ist deshalb an ein Selfie gebunden: Es wird mit dem Registrierungsfoto abgeglichen, das NIMC für diese NIN speichert, und der Datensatz wird nur zurückgegeben, wenn beide Fotos dieselbe Person zeigen.
  • Übereinstimmung: source_data enthält den NIMC-Datensatz und face_match_score. Die von Ihnen gesendeten Namen und das Geburtsdatum werden damit verglichen und in validation ausgewiesen. Senden Sie diese Angaben, um ein Ergebnis für Name und Geburtsdatum zu erhalten. Lassen Sie sie weg, dann lesen Sie die Werte des Registers aus source_data.
  • Andere Person: BIOMETRIC_NO_MATCH. Zurückgegeben wird nur face_match_score, keine personenbezogenen Daten.
  • Abgleich nicht möglich: INCONCLUSIVE, wenn NIMC für die NIN kein Foto speichert oder kein Gesicht gefunden wird. Es wird nichts zurückgegeben, und die Prüfung wird zur Prüfung weitergeleitet.
  • Unbekannte NIN: DOCUMENT_NOT_FOUND. Die Abfrage wird berechnet.
In einem Workflow stammt das Selfie aus dem Liveness- oder Gesichtsabgleich-Schritt. Hat der Workflow keinen Gesichtsschritt, wird das Porträt auf dem hochgeladenen Dokument verwendet. Eine Anfrage ohne Selfie oder mit einer NIN, die nicht aus 11 Ziffern besteht, wird abgelehnt, bevor etwas berechnet wird.

Weiterlesen

Zuletzt geändert am 7. November 2026