Zum Hauptinhalt springen
POST
Prüft die argentinische DNI gegen das offizielle Personenstandsregister RENAPER und führt einen biometrischen Gesichtsabgleich mit dem hinterlegten Foto durch. 100% Bevölkerungsabdeckung. Didit stellt diesen Dienst über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten gegen die maßgebliche Quelle prüfen und normalisierte Übereinstimmungsergebnisse erhalten. Eingabeformat: document_number nimmt die argentinische DNI entgegen (7-8 Ziffern, optionales Präfix M/F).

Abdeckung

  • Abdeckung: 100%
  • Land: Argentinien
  • Service-ID: arg_renaper
  • Datenbereich: Identität
  • Kategorie: NationalIDRegistry
RENAPER ist das Register, das jede argentinische DNI ausstellt. Daher ist jede DNI-Nummer hinterlegt, auch die DNIs, die an ausländische Einwohner ausgestellt wurden. Der Gesichtsabgleich vergleicht das Selfie mit dem Foto, das RENAPER zu dieser DNI gespeichert hat.

Eingaben

  • Erforderliche Eingaben: document_number, selfie, gender
  • 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.20 pro erfolgreiche Abfrage

Body-Parameter

string
Standard:"ARG"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: ARG
string
Standard:"arg_renaper"
erforderlich
Array mit der ID dieses Dienstes. Das Festlegen des Dienstes beschränkt die Anfrage auf genau diese Datenbank.Beispiel: arg_renaper
string
Standard:"11111111"
erforderlich
Dokumentnummer, die aus dem Dokument des Benutzers ausgelesen oder vom Benutzer angegeben wurde.Beispiel: 11111111
file
erforderlich
Selfie-Bilddatei, die für die biometrische Datenbankvalidierung hochgeladen wird. Akzeptierte Formate: JPEG, PNG oder WebP.Beispiel: @./selfie.jpg
string
Standard:"M"
erforderlich
Geschlechtsangabe, sofern von der Datenbank erforderlich.Erlaubte Werte: M (männlich), F (weiblich), X (andere oder unbekannt).Beispiel: M
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 Rauschen bei der Duplikaterkennung zu verringern.Beispiel: user-1234

Eingaberegeln und Validierungshinweise

  • Argentinische DNI (7-8 Ziffern, optionales Präfix M/F)
  • document_number muss 7-9 Zeichen lang sein.
  • document_number muss dem Muster [MFmf]?\d{7,8} entsprechen.

So rufen Sie es auf

Zurückgegebene Daten

Die genauen Felder, die in source_data ausgegeben werden, hängen davon ab, was das Register zurückgibt. Das generierte Beispiel für arg_renaper dokumentiert derzeit diese normalisierte Struktur:
  • date_of_birth
  • face_match_score
  • first_name
  • full_name
  • identification_number
  • last_name
  • tax_id
  • tax_id_type

Preise & SLAs

Argentinien: Abfragen zur DNI-Verifizierung (RENAPER) werden nur abgerechnet, wenn Didit ein eindeutiges Ergebnis von der Validierungsquelle erhält.
  • Preis pro Aufruf: $0.20 USD.
  • Abrechnung: pro erfolgreiche Abfrage. Ihnen wird nichts berechnet, wenn das Register nicht erreichbar ist, wenn erforderliche Felder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
  • Latenz: typischerweise p95 unter 2 s.
  • Verfügbarkeit: 99.9% pro Quartal auf Seiten von Didit; die Verfügbarkeit der nachgelagerten Quelle variiert je nach Land und Datensatz.

Übereinstimmungswert des Gesichtsabgleichs

face_match_score ist die Ähnlichkeit, die RENAPER zwischen dem Selfie und dem Foto in den Registerdaten zur DNI ermittelt. Der Wert wird als ganze Zahl von 0 bis 100 in einem String übergeben, zum Beispiel "92". Es handelt sich nicht um eine Wahrscheinlichkeit zwischen 0 und 1. Die Prüfung liefert BIOMETRIC_NO_MATCH, wenn RENAPER meldet, dass das Gesicht nicht übereinstimmt, oder wenn der Übereinstimmungswert unter 50 liegt. Ab 50 gilt das Gesicht als akzeptiert, und anschließend werden der hinterlegte Name und das Geburtsdatum mit den von Ihnen übermittelten Daten verglichen. Das Foto in den Registerdaten kann mehrere Jahre alt sein. Deshalb kann ein echter Benutzer bei einer deutlichen Veränderung seines Aussehens einen niedrigen Übereinstimmungswert erhalten. Erwägen Sie, BIOMETRIC_NO_MATCH zur manuellen Prüfung weiterzuleiten, statt den Vorgang sofort abzulehnen. Nutzen Sie dafür die Aktionen für Teilübereinstimmung/keine Übereinstimmung.

Wenn RENAPER nicht antwortet

Kann RENAPER nicht erreicht werden oder antwortet mit einem Fehler, lautet das Ergebnis REGISTRY_UNAVAILABLE. Die Person wurde dann nicht geprüft, und der Aufruf wird nicht berechnet. Dieselbe Anfrage kann bei einem späteren Wiederholungsversuch erfolgreich sein. Wie Sie damit umgehen, erfahren Sie unter Outcome Codes.

Dokumente, die ein Workflow auswertet

Innerhalb eines Workflows stammen die DNI-Nummer und das Geschlecht aus dem Schritt Ausweisverifizierung, der die argentinische DNI-Karte und die digitale DNI auswertet. Ausländische Einwohner besitzen dieselbe DNI-Karte und werden auf dieselbe Weise verifiziert. Die alte DNI-Heftform (libreta) wird von der Ausweisverifizierung nicht unterstützt. Ein Benutzer, der nur diese besitzt, kann den Schritt daher nicht abschließen. Die DNI-Nummer können Sie dennoch direkt mit POST /v3/database-validation/ prüfen.

In einem Workflow verwenden

Fügen Sie den Dienst nach der Ausweisverifizierung einem Schritt Datenbankvalidierung hinzu. Ein Beispiel mit POST /v3/workflows/:
Steht davor ein Schritt Liveness-Erkennung, vergleicht RENAPER das Live-Selfie. Ohne diesen Schritt sendet Didit stattdessen das auf dem Ausweisdokument abgedruckte Porträt. Dadurch wird das Dokumentfoto bestätigt, nicht aber, dass die Person vor der Kamera der Inhaber des Dokuments ist. Eine Dienst-ID, die der Workflow nicht ausführen kann, wird mit einem 400 abgelehnt, das sie benennt. Der Schritt wird dadurch nie ohne die von Ihnen angeforderte Prüfung gespeichert. Alle Einstellungen der Datenbankvalidierung finden Sie unter Workflow-Funktionskonfigurationen.

Weiterführende Informationen

Zuletzt geändert am 7. November 2026