> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Ausweisverifizierungsbericht: Felder & Qualitätswerte > Didits Ausweisverifizierungsbericht liefert Status, Dokumentfelder, Bildqualitätswerte und Sitzungsabgleiche in den API-Antworten. ## Übersicht Der **Bericht zur Ausweisverifizierung** erfasst alles, was Didit aus einem behördlichen Ausweisdokument extrahiert und validiert hat – Reisepässe, Personalausweise, Führerscheine und Aufenthaltstitel. Er bündelt die per OCR erfassten biografischen Daten und Dokumentenfelder, signierte URLs zu den aufgenommenen Medien, analysierte und geolokalisierte Adressdaten, Bildqualitätswerte pro Seite, MRZ-Inhalte, Aufschlüsselungen nach mehreren Schriftsystemen (lateinisch / nicht-lateinisch) sowie sitzungsübergreifende Dokumentenabgleiche. Der Bericht wird erstellt, nachdem der Benutzer den Schritt zur Dokumentenerfassung in einem Workflow abgeschlossen hat (oder den Standalone-OCR-Endpoint aufruft). Didit identifiziert den Dokumenttyp, führt OCR durch, validiert die MRZ / den Barcode / den QR-Code, parst die Adresse, prüft auf Manipulationen (Bildschirmaufnahme, gedruckte Kopie, Porträtmanipulation) und gleicht das Dokument mit jedem anderen in Ihrer Anwendung erfassten Dokument ab. Jeder Bericht enthält einen eigenen `status` – unabhängig vom allgemeinen Sitzungsstatus –, der widerspiegelt, wie der Ausweisschritt allein abgeschlossen wurde: * **Genehmigt** – Dokument erkannt, alle erforderlichen Felder extrahiert, keine Warnung ausgelöst, die zur Ablehnung führt. * **In Überprüfung** – eine oder mehrere Warnungen wurden ausgelöst und Ihr Workflow leitet diese zur Prüfung weiter. * **Abgelehnt** – eine Bedingung zur automatischen Ablehnung wurde ausgelöst (nicht unterstütztes Dokument, abgelaufenes Dokument, fehlendes Porträt, Treffer auf der Sperrliste, Fehlschlag bei adaptiver Altersschätzung) oder es wurde eine Warnung ausgelöst, deren konfigurierte Aktion Ablehnen ist (für Mindest-/Höchstalter ist standardmäßig die Aktion „Ablehnen“ konfiguriert). * **Abgelaufen** – das `expiration_date` des Dokuments ist **nach** der Verifizierung verstrichen. Die laufende Überwachung des Ablaufdatums von Didit ändert den Bericht von `Approved` zu `Expired`, fügt eine `DOCUMENT_EXPIRED`-Warnung hinzu und versetzt eine genehmigte Sitzung in den Sitzungsstatus `Kyc Expired`. * **Nicht abgeschlossen** – der Benutzer hat den Erfassungsschritt nie abgeschlossen. ## Wo er in API-Antworten erscheint Der Ausweisbericht wird innerhalb des `id_verifications[]`-Arrays bereitgestellt – **immer als JSON-Array**, niemals als einzelnes `id_verification`-Objekt. Mehrere Einträge erscheinen, wenn ein Workflow mehr als einen Dokumentenschritt ausführt (beispielsweise einen primären Ausweis plus eine Folgeverifizierung). * **Sitzungsentscheidungs-API** – `GET /v3/session/{sessionId}/decision/` gibt `id_verifications[]` auf oberster Ebene zurück. Siehe [Sitzungsentscheidung abrufen](https://docs.didit.me/de/sessions-api/retrieve-session.md). * **Webhooks** – Payloads von `session.status.updated` enthalten dasselbe `id_verifications[]`-Array, sobald der Schritt Daten geliefert hat. Siehe [Webhooks](https://docs.didit.me/de/integration/webhooks.md). * **Standalone-OCR-API** – die direkte Dokumentenübermittlung gibt ein einzelnes `id_verification`-Objekt mit denselben Feldern zurück. Siehe [Standalone-OCR-API](https://docs.didit.me/de/standalone-apis/id-verification.md). > [!NOTE] > > Lesen Sie `response.id_verifications[0]` und iterieren Sie über das Array. Die Form als einzelnes `id_verification`-Objekt existiert nur in der Standalone-OCR-API – sie existiert nicht am v3-Entscheidungs-Endpoint. ## Schema Das kanonische Schema Feld für Feld befindet sich auf der Referenzseite [Datenmodelle](https://docs.didit.me/de/reference/data-models.md#ausweisverifizierung). Die folgenden Felder stammen direkt aus `IDVerificationV3Serializer`, der `IDVerificationV2Serializer` erweitert und `node_id`, das sitzungsübergreifende Array `matches[]` sowie das Silent-Capture-Array `document_selfie_face_matches[]` hinzufügt. ### Felder der obersten Ebene | Feld | Typ | Beschreibung | | - | - | - | | `status` | `"Approved" \| "Declined" \| "In Review" \| "Expired" \| "Not Finished"` | Status des Ausweisschritts. | | `node_id` | string \| null | Workflow-Graph-Knoten, der diesen Bericht generiert hat. | | `document_type` | `"Passport" \| "Identity Card" \| "Driver's License" \| "Residence Permit" \| "Health Insurance Card" \| "Tax Card" \| "Social Security Card" \| "Work Permit" \| "Visa" \| "Public Service Card" \| "Birth Certificate" \| "Firearm License" \| "Other" \| null` | Erkannte Dokumentenfamilie der obersten Ebene (menschenlesbar). | | `document_subtype` | string \| null | Dokumenten-Subtyp-Code aus dem Dokumentenregister von Didit, gefiltert nach den von den Dokumenteneinstellungen des Workflows akzeptierten Werten. Regionsspezifische Dokumente enthalten die Region, zum Beispiel `QUEENSLAND_DRIVER_LICENSE_GENERIC`. Siehe [Dokumenten-Subtypen](https://docs.didit.me/de/core-technology/id-verification/document-subtypes-id-verification.md) für die vollständige Codeliste, einschließlich Hinweisen zur Unterscheidung eines US-amerikanischen gewerblichen Führerscheins (CDL) von einem Standardführerschein. | | `document_number` | string | Per OCR erfasste Dokumentennummer. Bei Führerscheinen, die sowohl eine Führerscheinnummer als auch eine Kartennummer aufweisen, beachten Sie den Hinweis unter der Tabelle. | | `personal_number` | string | Per OCR erfasste persönliche Identifikationsnummer / nationale Identifikationsnummer, sofern sie sich von der Dokumentennummer unterscheidet. | | `portrait_image`, `front_image`, `front_video`, `back_image`, `back_video`, `full_front_image`, `full_back_image` | string (signierte URL) | Erfasste Medien. URLs sind signiert und zeitlich begrenzt – laden Sie sie zeitnah herunter, speichern Sie die URL niemals dauerhaft. | | `front_image_camera_front`, `back_image_camera_front` | string (signierte URL) \| null | Während der Dokumentenerfassung von der nach vorne gerichteten Kamera des Benutzers aufgenommene Frames. Wird für den kameraübergreifenden Gesichtsabgleich verwendet und mit Ihrer [Gesichts-Sperrliste](https://docs.didit.me/de/console/blocklist-users.md#gesichts-sperrung) abgeglichen; jedes Bild kann auch [zur Gesichts-Sperrliste hinzugefügt werden](https://docs.didit.me/de/management-api/lists/create-entry.md#gesichter-aus-dem-selfie-der-dokumentenaufnahme). | | `front_image_camera_front_face_match_score`, `back_image_camera_front_face_match_score` | float (0–100) \| null | Ähnlichkeitswert zwischen dem Frame der Frontkamera und dem Porträt auf dem Dokument. | | `document_selfie_face_matches` | array \| null | Vorherige Sitzungen oder Einträge der Gesichts-Sperrliste, deren Gesicht mit dem während der Dokumentenerfassung aufgenommenen Selfie übereinstimmte ([Silent Capture Gesichtssuche](https://docs.didit.me/de/core-technology/face-search/overview.md#das-bei-der-dokumentenerfassung-aufgenommene-selfie)). Gleiches Eintragsformat wie `liveness_checks[].matches`; `match_image_url` ist eine vorab signierte URL, die abläuft. `null` bei älteren Sitzungen oder wenn die Suche nicht ausgeführt wurde, `[]`, wenn sie ausgeführt wurde und keine Treffer gefunden wurden. | | `front_image_quality_score`, `back_image_quality_score` | object \| null | Qualitätsbewertung pro Seite (siehe Bildqualitäts-Scores). | | `document_liveness` | object \| null | Dokument-Liveness-Scores pro Betrugsart zusammen mit den Schwellenwerten, anhand derer sie bewertet wurden (siehe Dokument-Liveness-Scores). Nur V3. | | `date_of_birth`, `expiration_date`, `date_of_issue` | string (YYYY-MM-DD) | Dokumentdaten. | | `age` | number | Aus `date_of_birth` berechnetes Alter des Inhabers in Jahren. | | `issuing_state` | string (ISO 3166-1 alpha-3) | Ländercode des Ausstellungslandes. | | `issuing_state_name` | string | Lokalisierter Ländername. | | `first_name`, `last_name`, `full_name` | string | Name des Inhabers im durch `preferred_characters` ausgewählten Schriftsystem (siehe unten). | | `gender` | `"M" \| "F" \| "U"` | Geschlecht, sofern auf dem Dokument vorhanden (`U` = unbekannt). | | `address`, `formatted_address` | string | Unformatierte und geokodierte/formatierte Adresszeichenfolgen. | | `place_of_birth` | string | Per OCR erfasster Geburtsort. | | `marital_status` | `"SINGLE" \| "MARRIED" \| "DIVORCED" \| "WIDOWED" \| "UNKNOWN"` | Familienstand, sofern auf dem Dokument vorhanden. | | `nationality` | string (ISO 3166-1 alpha-3) | Staatsangehörigkeit des Inhabers, sofern abweichend vom Ausstellungsstaat. | | `extra_fields` | object | Dokumentenspezifische Zusatzfelder (Führerscheinklassen, Blutgruppe, Namen in alternativen Schriftsystemen, `tax_number`, …). | | `mrz` | object \| null | Geparste MRZ-Schlüssel/Wert-Felder. | | `parsed_address` | object \| null | Strukturierte, geokodierte Adresse (`street_1`, `street_2`, `city`, `region`, `country`, `postal_code`, `address_type`, `formatted_address`, `document_location`, `raw_results`, `is_best_match`). | | `extra_files[]` | Array signierter URLs | Zusätzliche, diesem Dokument beigefügte Bilder. | | `matches[]` | array | Sitzungsübergreifende Dokumentenübereinstimmungen (siehe Sitzungsübergreifende Übereinstimmungen). | | `warnings[]` | array | Warnungen auf Modulebene – siehe [Warnungen zur Ausweisverifizierung](https://docs.didit.me/de/core-technology/id-verification/warnings-id-verification.md). | > [!NOTE] > > **`issuing_state` ist immer auf Länderebene, niemals auf subnationaler Ebene.** Bei jedem > Dokumententyp, einschließlich Führerscheinen, die von einem Bundesstaat oder einer Provinz > ausgestellt wurden (Australien, die Vereinigten Staaten, Kanada), geben `issuing_state` und > `issuing_state_name` das **Land** an (zum Beispiel `AUS` / > `Australia`), nicht den Bundesstaat. Der subnationale Wert ist, sofern das Dokument > einen solchen enthält, separat in `parsed_address.region` verfügbar (bei > einigen Dokumententypen als Fallback in `extra_fields.state`). Die Sitzungsübersicht der > **Business Console** zeigt dies, falls vorhanden, als Zeile **Region** unterhalb von > **Ausstellungsstaat** an. > [!NOTE] > > **Führerscheine mit zwei Nummern (Australien).** Australische Führerscheine > enthalten sowohl eine Führerscheinnummer, die die Fahrberechtigung des Inhabers > identifiziert und beim Austausch einer Karte unverändert bleibt, als auch eine Kartennummer, > die die physische Karte identifiziert und sich bei jeder Neuausstellung ändert. Für diese > Führerscheine ordnet Didit die Nummern stets gleich zu: > > * `personal_number` — die **Führerscheinnummer** > * `document_number` — die **Kartennummer** > > Dies gilt für jeden australischen Bundesstaat und jedes Territorium (NSW, VIC, QLD, WA, SA, > TAS, ACT, NT). Bei einigen Varianten ist die Kartennummer nur auf der Rückseite aufgedruckt, > sodass sie nur erfasst wird, wenn die Rückseite des Führerscheins aufgenommen wird. Wenn keine Kartennummer > ausgelesen werden kann, wird die Führerscheinnummer sowohl als > `document_number` als auch als `personal_number` ausgegeben, sodass `document_number` nach > Abschluss der Verifizierung immer eine Kennung enthält. `personal_number` ist in jedem Fall > die Führerscheinnummer. Bei anderen Dokumententypen bleibt `document_number` die > primäre per OCR erfasste Nummer und kann selbst eine Kennung auf Inhaberebene sein. > [!NOTE] > > **Die argentinische CUIL ist `extra_fields.tax_number`, niemals `personal_number`.** > Argentinische Dokumente drucken die CUIL – die 11-stellige Kennung, auf die sich AFIP, ANSES und > die Auskunfteien beziehen – auf jedem Dokument an einer anderen Stelle ab, und > der DNI druckt eine zweite 11-stellige Nummer daneben: > > * Auf dem **Führerschein** enthält `personal_number` die CUIL; > * auf dem **DNI** enthält `personal_number` die *número de trámite*, welche > den Kartenantrag identifiziert und keine Kennung des Inhabers ist. > Die CUIL des DNI wird aus dem dafür vorgesehenen gedruckten Feld ausgelesen. > > Daher ist `personal_number` für Argentinien **keine** verlässliche CUIL: Auf einem DNI handelt es sich > um eine 11-stellige Nummer, die bei Abfragen in Registern stillschweigend kein Ergebnis liefert. > Lesen Sie stattdessen `extra_fields.tax_number` aus. Didit gibt dieses Feld nur zurück, wenn der Wert > als echte CUIL validiert wird (Personenpräfix plus Modulo-11-Prüfziffer), als > kanonische Ziffernfolge ohne Trennzeichen (`27111111117`), unabhängig davon, welches argentinische > Dokument der Inhaber vorgelegt hat. Wenn die CUIL der Karte nicht gelesen werden konnte, > fehlt der Schlüssel, anstatt mit einer Nummer befüllt zu werden, die keine CUIL ist – erfassen > Sie den Führerschein als zweites Dokument oder erfassen Sie die CUIL über eine > Antwort auf einen Fragebogen oder die `metadata` der Sitzung, um diese Benutzer abzudecken. ### Bildqualitäts-Scores `front_image_quality_score` und `back_image_quality_score` geben jeweils Folgendes zurück: | Feld | Typ | Was gemessen wird | | - | - | - | | `focus_score` | number 0–100 | Schärfe – obere 10 % der lokalen Laplace-Varianz, robust gegenüber einheitlichen Hintergründen. Gewichtung 45 %. | | `brightness_score` | number 0–100 | Bestraft zu dunkle oder überbelichtete Bilder. Gewichtung 30 %. | | `brightness_issue` | `"ok" \| "too_dark" \| "too_bright"` | Art des Helligkeitsproblems, wenn `brightness_score` niedrig ist. | | `resolution_score` | number 0–100 | Basiert auf der Gesamtzahl der Pixel der Aufnahme. Gewichtung 25 %. | | `is_document_fully_visible` | boolean \| null | `true`, wenn alle vier Dokumentecken sichtbar sind, `false`, wenn eine Ecke abgeschnitten ist, `null`, wenn die Eckenerkennung nicht verfügbar war. | | `overall_score` | number 0–100 | Gewichteter Gesamtwert (Schärfe 45 %, Helligkeit 30 %, Auflösung 25 %). | > [!TIP] > > Nutzen Sie `overall_score` als schnelle Eignungsprüfung – Werte über **70** deuten im Allgemeinen auf eine Aufnahme hin, die gut genug für eine zuverlässige Verifizierung ist. ### Dokument-Liveness-Scores `document_liveness` gibt an, was die [Dokument-Liveness-Prüfung](https://docs.didit.me/de/core-technology/id-verification/warnings-id-verification.md#dokumenten-liveness-manipulation) gemessen hat, **unabhängig davon, ob eine Warnung ausgelöst wurde oder nicht**. Eine Warnung existiert nur dann, wenn ein Wert einen der Schwellenwerte des Workflows unterschritten hat. Vor Einführung dieses Feldes enthielt ein genehmigtes Dokument daher keinerlei Nachweise zur Liveness-Erkennung – über dieses Feld können Sie eine erfolgreich durchlaufene Sitzung prüfen. Es ist `null`, wenn die Prüfung nicht ausgeführt wurde (beispielsweise bei einer Methode ohne Dokument oder bei einem in den Sitzungs-Logs erfassten Modellausfall). Es enthält ein Objekt pro Betrugsart – `portrait_replace`, `printed_copy` und `screen_replay` – jeweils mit: | Feld | Typ | Bedeutung | | - | - | - | | `score` | number 0–100 \| null | Wahrscheinlichkeit, dass das Dokument bezüglich dieser Betrugsart echt ist (höher = mit höherer Wahrscheinlichkeit echt). Es ist der **niedrigere** Wert der beiden Seiten, welcher für die Entscheidung herangezogen wurde. `null`, wenn keine der Seiten einen verwertbaren Wert erbracht hat – beispielsweise entfällt der Porträt-Score auf einer Seite, auf der kein Porträt gefunden wurde. | | `front`, `back` | number 0–100 \| null | Derselbe Wert pro erfasster Seite. `null` für eine Seite, die nicht erfasst wurde oder deren Wert verworfen wurde. | | `decline_threshold`, `review_threshold` | number \| null | Schwellenwerte, die gespeichert wurden, als der Ausweisverifizierungs-Knoten dieses Dokument ausgewertet hat. Spätere Änderungen am Workflow ändern diese nicht. `null`, wenn historische Bewertungsdaten nicht verfügbar sind. | | `bucket` | `"approve" \| "review" \| "decline" \| null` | Einstufung von `score` im Vergleich zu diesen Schwellenwerten: unterhalb von `decline_threshold` → `decline`, unterhalb von `review_threshold` → `review`, andernfalls `approve`. `null`, wenn kein verwertbarer Wert vorliegt, die Prüfung nicht angewendet wurde oder historische Bewertungsdaten nicht verfügbar sind. Das Bucket beschreibt die Prüfung auf diese Betrugsart, nicht den Gesamtstatus der Sitzung. | ```json theme={null} "document_liveness": { "portrait_replace": { "score": 96.46, "front": 96.46, "back": 98.2, "decline_threshold": 35, "review_threshold": 70, "bucket": "approve" }, "printed_copy": { "score": 91.2, "front": 91.2, "back": 93.7, "decline_threshold": 35, "review_threshold": 77, "bucket": "approve" }, "screen_replay": { "score": 99.9, "front": 99.9, "back": 99.5, "decline_threshold": 30, "review_threshold": 70, "bucket": "approve" } } ``` Bei älteren Dokumenten ohne gespeicherte Bewertungsnachweise bleiben gespeicherte Werte sichtbar, aber sowohl Schwellenwerte als auch `bucket` sind `null`. Aktuelle Workflow-Einstellungen werden niemals zur Rekonstruktion eines historischen Ergebnisses herangezogen. Dasselbe gilt für eine Erfassung, deren Dokumentauswertung noch nicht abgeschlossen ist. Die Business Console zeigt dieselben drei Zeilen im Block **Dokument-Liveness-Erkennung** des Bereichs Ausweisverifizierung der Sitzung an. ### Sitzungsübergreifende Übereinstimmungen `matches[]` listet bis zu **5** andere Dokumente in Ihrer Anwendung auf, die mit diesem übereinstimmen – gleiches **Geburtsdatum**, gleiches **Ausstellungsland** und ein stark ähnlicher **vollständiger Name**. Dokumente auf der Sperrliste erfordern zusätzlich eine exakte Übereinstimmung der Dokumentnummer. Sitzungen desselben Benutzers (gleiche `vendor_data`) werden ausgeschlossen. Jeder Eintrag enthält `session_id`, `session_number`, `vendor_data`, `verification_date`, `user_details` (`name`, `document_type`, `document_number`), `status`, `is_blocklisted` (`true`, wenn das Dokument zu Ihrer Sperrliste hinzugefügt wurde), `api_service` und eine signierte `front_image_url`. ## Statuswerte | Status | Bedeutung | Nachgelagerte Auswirkung | | - | - | - | | `Approved` | Dokument erkannt, erforderliche Felder extrahiert, alle Prüfungen bei den konfigurierten Schwellenwerten bestanden. | Zählt als erfolgreiche Ausweisprüfung. | | `In Review` | Eine oder mehrere Warnungen wurden ausgelöst und der Workflow leitet sie zur Prüfung weiter. | Die Sitzung wechselt ebenfalls zu `In Review`, bis ein Prüfer reagiert. | | `Declined` | Bedingung für automatische Ablehnung ausgelöst (nicht unterstütztes Dokument, abgelaufenes Dokument, Porträt fehlt, Treffer auf der Sperrliste, Fehlschlag bei adaptiver Altersprüfung) oder eine auf Ablehnen konfigurierte Warnung wurde ausgelöst. | Die Sitzung wird abgelehnt, es sei denn, eine andere genehmigte Verzweigung erfüllt den Workflow. | | `Expired` | Das Ablaufdatum des Dokuments wurde **nach** der Genehmigung überschritten. Wird durch die laufende Dokumentenüberwachung von Didit festgelegt, die standardmäßig aktiviert ist (ein Land und ein Dokumenttyp, für die **Expiration mode** auf **Allow expired** steht, sind ausgenommen), zusammen mit einer `DOCUMENT_EXPIRED`-Warnung. | Eine genehmigte Sitzung wechselt zu `Kyc Expired`. | | `Not Finished` | Der Benutzer hat den Erfassungsschritt abgebrochen. | Die Ausweis-Verzweigung hat kein Ergebnis geliefert. | ## Dokumente mit mehreren Schriftsystemen (lateinisch / nicht-lateinisch) Einige Dokumente — kirgisische, kasachische, russische, japanische, koreanische, chinesische, arabische, thailändische und andere — drucken den Namen, die Adresse oder den Geburtsort des Inhabers **sowohl** in einer lateinischen Transliteration **als auch** im lokalen Schriftsystem ab. Sie wählen über die Workflow- (oder Standalone-API-)Einstellung `preferred_characters`, welches Schriftsystem die Felder der obersten Ebene befüllt: | Wert | Befüllt Felder der obersten Ebene mit | Die Werte des jeweils anderen Schriftsystems werden in | | - | - | - | | `latin` *(Standard)* | Der auf dem Dokument aufgedruckten lateinischen Transliteration | `extra_fields.*_non_latin` | | `non_latin` | Den auf dem Dokument aufgedruckten Werten im lokalen Schriftsystem | `extra_fields.*_latin` | Die Werte des alternativen Schriftsystems befinden sich in `extra_fields` unter Schlüsseln mit Suffix: `first_name_non_latin`, `last_name_non_latin`, `middle_name_non_latin`, `full_name_non_latin`, `address_non_latin`, `place_of_birth_non_latin` (oder den entsprechenden `_latin`-Varianten). ### Wann Felder des alternativen Schriftsystems erscheinen * **Nur wenn tatsächlich beide Schriftsysteme auf dem Dokument vorhanden sind.** Wenn ein OCR-Feld, das nominell mit „Surname-Kyrgyz (Cyrillic)“ gekennzeichnet ist, als Text in lateinischer Schrift extrahiert wird (Homoglyphen oder eine lateinische Transliteration), gilt es **nicht** als nicht-lateinische Alternative und dieser Schlüssel wird weggelassen. * `full_name_non_latin` (und `full_name_latin`) werden immer aus den einzelnen Vor-, Mittel- und Nachnamensbestandteilen **rekonstruiert**, wenn beide verfügbar sind — das Rohfeld „Full Name“ aus der OCR wird zur Gewährleistung der Konsistenz ignoriert. * Wenn `preferred_characters=latin` gesetzt ist, das Dokument jedoch **ausschließlich** nicht-lateinischen Text enthält (sodass die Felder der obersten Ebene nicht-lateinische Werte enthalten), führt Didit einen Transliterationsschritt durch und stellt `first_name_latin`, `last_name_latin`, `middle_name_latin`, `full_name_latin`, `place_of_birth_latin` und `address_latin` als lateinischen Fallback bereit. ```json theme={null} { "first_name": "John", "last_name": "Doe", "full_name": "John Doe", "extra_fields": { "first_name_non_latin": "Айна" } } ``` `last_name_non_latin` fehlt, weil das Feld „Surname (Cyrillic)“ des Dokuments bei diesem Beispiel lateinische Zeichen zurückgegeben hat — es gab keinen echten nicht-lateinischen Nachnamen zum Extrahieren. ## Beispiele ### Approved — einwandfreier spanischer Personalausweis (alle Felder) ```json theme={null} { "id_verifications": [ { "status": "Approved", "document_type": "Identity Card", "document_subtype": "ID_CARD_GENERIC", "document_number": "SAMPLE-DOC-12345", "personal_number": "SAMPLE-PER-12345", "portrait_image": "https:///.../portrait.jpg?signature=...", "front_image": "https:///.../front.jpg?signature=...", "front_video": "https:///.../front.mp4?signature=...", "back_image": "https:///.../back.jpg?signature=...", "back_video": "https:///.../back.mp4?signature=...", "full_front_image": "https:///.../full_front.jpg?signature=...", "full_back_image": "https:///.../full_back.jpg?signature=...", "front_image_camera_front": null, "back_image_camera_front": null, "front_image_camera_front_face_match_score": null, "back_image_camera_front_face_match_score": null, "front_image_quality_score": { "focus_score": 85.3, "brightness_score": 92.1, "brightness_issue": "ok", "is_document_fully_visible": true, "resolution_score": 72.4, "overall_score": 84.6 }, "back_image_quality_score": { "focus_score": 79.1, "brightness_score": 90.5, "brightness_issue": "ok", "is_document_fully_visible": true, "resolution_score": 72.4, "overall_score": 81.5 }, "date_of_birth": "1990-01-01", "age": 35, "expiration_date": "2031-06-02", "date_of_issue": "2021-06-02", "issuing_state": "ESP", "issuing_state_name": "Spain", "first_name": "John", "last_name": "Doe", "full_name": "John Doe", "gender": "M", "address": "Avda de Madrid 34", "formatted_address": "Avda de Madrid 34, Madrid, Madrid 28822, Spain", "place_of_birth": "Madrid", "marital_status": "SINGLE", "nationality": "ESP", "extra_fields": {}, "mrz": { "document_number": "SAMPLE-DOC-12345", "surname": "DOE", "name": "JOHN", "birth_date": "900101", "expiry_date": "310602" }, "parsed_address": { "street_1": "Avda de Madrid 34", "street_2": null, "city": "Madrid", "region": "Madrid", "country": "ES", "postal_code": "28822", "address_type": "Avda", "formatted_address": "Avda de Madrid 34, Madrid, Madrid 28822, Spain", "document_location": { "latitude": 40.4168, "longitude": -3.7038 }, "raw_results": { "geometry": { "location": { "lat": 40.4168, "lng": -3.7038 }, "location_type": "ROOFTOP" } }, "is_best_match": true }, "extra_files": [], "warnings": [], "node_id": "id_primary", "matches": [] } ] } ``` ### In Review — QR-Code auf einem Dokument nicht erkannt, das einen aufweisen sollte Gekürzt — eine echte Antwort enthält immer den vollständigen Satz der oben gezeigten Felder. ```json theme={null} { "id_verifications": [ { "status": "In Review", "node_id": "id_primary", "document_type": "Identity Card", "document_subtype": "ID_CARD_GENERIC", "document_number": "SAMPLE-DOC-12345", "first_name": "John", "last_name": "Doe", "full_name": "John Doe", "warnings": [ { "feature": "ID_VERIFICATION", "risk": "QR_NOT_DETECTED", "additional_data": null, "log_type": "warning", "short_description": "QR not detected", "long_description": "The system couldn't find or read the QR code on the document. This could be due to poor image quality or an unsupported document type.", "node_id": "id_primary" } ] } ] } ``` ## Sicherheitshinweis Die für Dokumentbilder und -videos zurückgegebenen signierten URLs sind temporär — sie laufen nach einem begrenzten Gültigkeitsfenster ab. Behandeln Sie sie als kurzlebig: Laden Sie zeitnah herunter, was Sie benötigen, und cachen oder machen Sie sie nicht öffentlich zugänglich. Typischerweise benötigt Ihre Anwendung nur `status`, eine Handvoll biografischer Felder und die Warnungen — speichern Sie so wenig wie möglich, um die Angriffsfläche bei einer künftigen Sicherheitsverletzung zu minimieren. ## Verwandte Themen * [Warnungen zur Ausweisverifizierung](https://docs.didit.me/de/core-technology/id-verification/warnings-id-verification.md) — vollständiges Warnungs-Enum, Ursachen und Behebung. * [Dokumentenüberwachung](https://docs.didit.me/de/core-technology/id-verification/document-monitoring-id-verification.md) — wie Didit auf Manipulationen und sitzungsübergreifende Duplikate prüft. * [Unterstützte Dokumente](https://docs.didit.me/de/core-technology/id-verification/supported-documents-id-verification.md) — welche Dokumenttypen und Länder abgedeckt sind. * [Dokument-Untertypen](https://docs.didit.me/de/core-technology/id-verification/document-subtypes-id-verification.md) — vollständige Codeliste für `document_subtype`, einschließlich der Erkennung von gewerblichen vs. standardmäßigen US-Führerscheinen. * [Webhooks](https://docs.didit.me/de/integration/webhooks.md) — auf `session.status.updated` lauschen, um den Bericht zu empfangen. * [Datenmodelle — Ausweisverifizierung](https://docs.didit.me/de/reference/data-models.md#ausweisverifizierung) — kanonisches Schema mit allen Feldern. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.