Datenextraktion
Eine OCR-API zum Scannen von Ausweisen, die strukturierte Felder zurückgibt, keinen Textblock.
ShieldID wandelt einen amtlichen Lichtbildausweis in strukturierte Daten pro Feld um: Name, Geburtsdatum, Dokumentnummer, Ablaufdatum, Adresse und mehr, wobei jedes Feld seine Quelle und sein eigenes Ergebnis mitführt. Eine API zur Dokumentendatenextraktion und eine API zur Dokumentenverifizierung in derselben Sitzung.
Was zurückgegeben wird
Strukturierte Felder, sofern das Dokument sie tatsächlich enthält.
Nicht jedes Dokument enthält jedes Feld. ShieldID liefert, was das Dokument enthält, und kennzeichnet, was es nicht enthält.
- Vollständiger Name
- Wie gedruckt und, sofern das Dokument einen Barcode oder eine MRZ enthält, wie darin codiert.
- Geburtsdatum
- Von der bedruckten Vorderseite gelesen und mit dem Barcode und der MRZ gegengeprüft.
- Dokumentnummer
- Führerschein- oder Reisepassnummer, auf interne Konsistenz geprüft, soweit das Format des Ausstellers dies zulässt.
- Ablaufdatum
- Von der bedruckten Vorderseite und vom Barcode oder der MRZ gelesen.
- Adresse
- Von der bedruckten Vorderseite und, sofern vorhanden, vom Barcode gelesen; vergleichbar mit einem separat hochgeladenen Adressdokument.
- Geschlecht
- Gelesen, sofern das Dokument es aufdruckt oder codiert.
- Ausstellende Jurisdiktion
- Wird anhand des Aussteller-Codes im Barcode identifiziert, sofern das Dokument einen erkannten Code enthält und dieser verfügbar ist.
Drei Quellen, ein Vergleich
Barcode, MRZ und die aufgedruckte Vorderseite – gezielt gelesen, nicht versehentlich vermischt.
Jedes Feld wird der Quelle zugeordnet, aus der es stammt. Wenn zwei Quellen voneinander abweichen, ist das ein Hinweis im Ergebnis und kein Mittelwert aus den beiden Angaben.
PDF417-Barcode
Die Rückseite eines nordamerikanischen Führerscheins oder Ausweises wird in strukturierte AAMVA-Felder dekodiert. Enthält ein Dokument einen Barcode, haben dessen Felder Vorrang vor der gedruckten Vorderseite.
Reisepass-MRZ
Die maschinenlesbare Zone wird lokalisiert, gelesen und anhand der in der Zone enthaltenen ICAO-Prüfziffernformeln validiert. Ein Mindest-Validitätswert, gegen den geprüft wird, entscheidet darüber, ob ein per MRZ gelesenes Feld überhaupt als vertrauenswürdig gilt – eine Zone, die ihre eigene Prüfsumme nicht besteht, darf eine sauberere Quelle nicht überstimmen.
Strukturierte OCR und Ganzseiten-OCR der Vorderseite
Die gedruckte Seite wird anhand des dokumenteigenen Layouts gelesen, sofern dieses erkannt wird. Andernfalls greift eine ganzseitige OCR, sodass auch ein unbekanntes Dokument lesbare Felder liefert.
Widersprüche werden markiert, nicht gemittelt
Ein Name oder Geburtsdatum, der zwischen Vorderseite, Barcode und MRZ voneinander abweicht, wird im Ergebnis als Abweichung gemeldet. Nichts in der Verarbeitungskette wählt stillschweigend einen Gewinner aus und verbirgt den Widerspruch.
MRZ-Prüfsummenvalidierung
Eine maschinenlesbare Zone muss ihre eigene Rechnung bestehen, bevor wir ihr vertrauen.
Die maschinenlesbare ICAO-Zone eines Reisepasses enthält bauartbedingt Prüfziffern. ShieldID validiert diese, bevor ein per MRZ gelesenes Feld als zuverlässig behandelt wird.
Ein spezieller Detektor lokalisiert die MRZ, ein Leser extrahiert die Zeichen, und das Ergebnis wird anhand der zoneneigenen Prüfsummenformeln auf Validität bewertet. Nur ein Feld, das den Mindest-Validitätswert erreicht, wird mit voller Priorität als vertrauenswürdig behandelt; eine Zone, die schlecht lesbar ist, wird entsprechend behandelt, statt so durchgereicht zu werden, als wäre sie sauber.
Barcode hat Vorrang
Wenn sich Quellen überschneiden, gewinnt die zuverlässigste.
Dasselbe Feld kann auf dem Barcode, in der MRZ und auf der aufgedruckten Vorderseite erscheinen. ShieldID löst das jedes Mal mit derselben, einheitlichen Reihenfolge auf.
- PDF417-Barcode
- Reisepass-MRZ, sobald sie ihre Prüfsumme besteht
- Strukturiertes Lesen der aufgedruckten Vorderseite
- Ganzseiten-OCR als Rückfalloption
Adressnachweise
Laden Sie ein zweites Dokument hoch und erhalten Sie einen unkomplizierten Adressvergleich.
Wenn eine Verifizierung einen Adressnachweis erfordert, lädt die antragstellende Person ein separates Dokument hoch, und ShieldID liest es auf dieselbe Weise wie den Ausweis.
Der Adressnachweis wird per OCR verarbeitet, und seine Adresse wird mit der Adresse verglichen, die aus dem Ausweisdokument gelesen wurde. Dabei handelt es sich um einen einfachen Text- und Token-Vergleich, nicht um einen separaten Dokumentklassifikator; er wird nur durchgeführt, wenn die Sitzung ihn erfordert und tatsächlich ein Dokument übermittelt wurde.
Schwärzung und Umgang mit personenbezogenen Daten
Extrahierte Daten werden genauso geschützt wie die Bilder.
Strukturierte Felder unterliegen denselben Datenschutzkontrollen wie die Ausweisfotos selbst.
Geburtsdatum im Ruhezustand verschlüsselt
Das Geburtsdatum wird im Ruhezustand verschlüsselt gespeichert; der Dienst läuft nicht ohne den vorhandenen Verschlüsselungsschlüssel.
Bilder werden zeitgesteuert gelöscht
Die aufgenommenen Dokument- und Selfie-Bilder werden automatisch nach kurzer Frist gelöscht, standardmäßig nach sieben Tagen. Eine Bereinigung läuft in einem festen Intervall und erneut kurz nach jedem Neustart, sodass ein Bild auch in ruhigen Phasen nie länger als vorgesehen gespeichert bleibt.
Score-Schwärzung auf dem Gerät
Wo ein Übereinstimmungs- oder Konfidenzwert sonst auf dem eigenen Telefon der antragstellenden Person angezeigt würde, entfernt ShieldID den zugrunde liegenden Prozentwert aus dieser Meldung, bevor sie angezeigt wird. So gelangt ein Rohwert nie außerhalb Ihres Kontos zur Anzeige.
Der Nachweis bleibt länger erhalten als die Bilder
Die Bilder werden nach Zeitplan gelöscht. Dass eine Verifizierung stattgefunden hat und was sie ergeben hat, bleibt in Ihrem Konto erhalten – und bei einer Trust Ledger-Integration als Eintrag „verifiziert/fehlgeschlagen“ im Activity Ledger (Ledger-Einträge für ShieldID-API-Konten: demnächst verfügbar).
Beispielergebnis
Verdikte pro Feld, in der Form, in der die API sie zurückgibt.
Die nachstehenden Namen, Nummern und Adressen sind für dieses Beispiel erfunden. Der Feldumfang, die Quellenangaben und die Verdikte entsprechen der tatsächlichen Struktur eines Ergebnisses.
| Feld | Wert | Quelle | Verdikt |
|---|---|---|---|
| person.name | "Priya Chandrasekaran" | barcode | match |
| person.dob | "1991-07-22" | barcode | match |
| person.document_number | "C4839201" | mrz | match |
| person.document_country | "CA" | barcode issuer code | match |
| person.address | "18 Spruce Ave, Ottawa ON" | barcode | match |
| identity.name_match | PASS | front vs barcode vs requester | PASS |
| checks.document_tamper | "no_indication" | advisory model | advisory — not gating |
// Sample result. Names, numbers and addresses are fictional.
{
"session_id": "ses_9f2c...sample",
"status": "VERIFIED",
"environment": "sandbox",
"person": {
"name": "Priya Chandrasekaran",
"dob": "1991-07-22",
"document_type": "DRIVERS_LICENCE",
"document_country": "CA",
"document_jurisdiction": "ON",
"address": "18 Spruce Ave, Ottawa ON"
},
"identity": {
"checks": ["name_match"],
"warnings": [],
"sources": {
"name": "barcode",
"dob": "barcode",
"address": "barcode"
}
},
"checks": {
"document": "PASS",
"identity": "PASS",
"document_tamper": "no_indication"
},
"completed_at": "2026-09-17T14:02:11Z"
}Hinweise zur Integration
Dieselben Felder, wo auch immer Sie das Ergebnis lesen.
Strukturierte Felder sind kein separates Produkt neben der Verifizierungssitzung. Sie kommen als Teil desselben Ergebnisses an.
- Die Felder werden im Sitzungsergebnis geliefert, das Sie nach Abschluss einer Verifizierung über die API abrufen.
- Dasselbe Ergebnis wird nach Abschluss der Verifizierung per signiertem Webhook an Ihren Endpunkt zugestellt, sodass Sie nicht abfragen müssen.
- Jedes Feld ist seiner Quelle zugeordnet und trägt sein eigenes Ergebnis, sowohl im API-Ergebnis als auch in der Webhook-Nutzlast.
- Sandbox-Sitzungen liefern dieselbe Feldstruktur wie die Produktion, sodass Sie Ihre Integration aufbauen können, bevor ein einziges echtes Dokument gelesen wird.
Fragen
Klare Antworten zur Datenextraktion.
Sehen Sie sich die Felder selbst an
Führen Sie eine Sandbox-Verifizierung durch und lesen Sie das strukturierte Ergebnis.
Erstellen Sie eine Sandbox-Sitzung, scannen Sie ein Dokument mit Ihrem eigenen Smartphone und sehen Sie in der Antwort jedes Feld, seine Quelle und sein Ergebnis. Sandbox-Sitzungen werden nie berechnet.