Senden Sie das Foto eines Reisepasses mit dem Ausstellungsland Deutschland und erhalten Sie strukturierte Daten in derselben HTTP-Antwort zurück – die maschinenlesbare Zone (MRZ) ausgewertet, die Prüfziffern nach ICAO 9303 geprüft und die Felder der Sichtzone extrahiert. Kein SDK zu installieren, keine Warteschlange abzufragen.
Ein Reisepass mit dem Ausstellungsland Deutschland folgt dem Standard ICAO 9303: eine zweizeilige maschinenlesbare Zone mit je 44 Zeichen (Format TD3) am unteren Rand der Datenseite, unterhalb der für Menschen lesbaren Sichtprüfzone. Ihre ersten fünf Zeichen sind P<DEU – der Dokumentcode, dann der ausstellende Staat als ISO-3166-1-Alpha-3-Code DEU. Die API liest beide Zonen, gleicht die MRZ-Prüfziffern ab und liefert eine einzige Antwortstruktur, in der jeder Schlüssel vorhanden ist.
In einer Alpha-2-Liste lautet der Code hier DE, in der Zone DEU (Deutschland): In diesem Fall ist der längere Code der kürzere mit U dahinter. Das gilt für dieses Paar, nicht als Regel: Wer den einen Code aus dem anderen ableitet, baut einen Fehler ein, der nur auf das erste Land wartet, bei dem es nicht passt.
9303 definiert drei Zonenlayouts, und die API liest alle drei. Unten steht eine erfundene Inhaberin – sie ist niemand, und paradeigma ist das griechische Wort für Beispiel – in jedem Layout, mit DEU als ausstellendem Staat. Jede Prüfziffer wird aus den Zeichen daneben berechnet statt eingetippt, daher ist jede Zone hier gültig.
2 Zeilen zu je 44 Zeichen. Staatsangehörigkeit DEU. Ausstellender Staat und Staatsangehörigkeit sind beide DEU: Ein Reisepass bescheinigt die Staatsangehörigkeit des Staates, der ihn ausgestellt hat.
P<DEUPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184DEU9403084F3203101PN48291630<<<<722 Zeilen zu je 36 Zeichen. Staatsangehörigkeit GRC. Von DEU an eine Person mit der Staatsangehörigkeit GRC ausgestellt, daher unterscheiden sich die beiden Codes. Der Name hat hier 31 Zeichen statt der 39 im Reisepass.
I<DEUPARADEIGMA<<ELENI<SOFIA<<<<<<<<
TR61850420GRC9403084F2911043<<<<<<<23 Zeilen zu je 30 Zeichen. Staatsangehörigkeit GRC. Drei Zeilen zu je 30 Zeichen, mit dem Namen in einer eigenen Zeile. Der Dokumentcode ist ID – 9303 Teil 5 legt das erste Zeichen als A, C oder I fest und überlässt das zweite dem ausstellenden Staat.
IDDEUAK472913<4PN48291630<<<<<
9403084F3405204GRC<<<<<<<<<<<9
PARADEIGMA<<ELENI<SOFIA<<<<<<<Keine Prüfziffer deckt den ausstellenden Staat ab: In allen drei Layouts läuft die Rechnung über die Dokumentnummer, die Daten und die optionalen Angaben, nie über die drei Zeichen, die sagen, wer das Dokument ausgestellt hat. Eine Zone, deren Ziffern alle stimmen, beweist nicht, dass das Dokument wirklich aus dem Ausstellungsland Deutschland stammt – das leisten die Sichtzone und die eigenen Sicherheitsmerkmale des Dokuments.
Fügen Sie eine MRZ in den MRZ-Parser ein, um ihre Prüfziffern zu validieren, oder erstellen Sie eine mit dem MRZ-Generator.
Jeder erkannte Reisepass mit dem Ausstellungsland Deutschland liefert dieselben strukturierten Felder. Ein Wert, der nicht gelesen werden konnte, ist null, nie ein fehlender Schlüssel.
Alle Felder finden Sie im Dokumentfeld-Explorer (auf Englisch).
Führen Sie dies gegen die öffentliche Sandbox aus – ohne Registrierung, mit echter Erkennung, kostenlos für eine begrenzte Zahl von Dokumenten und 10 Anfragen pro Stunde und IP. Ersetzen Sie den Sandbox-Schlüssel durch Ihren eigenen Live-Schlüssel, um weiter Reisepässe mit dem Ausstellungsland Deutschland zu erkennen.
curl -X POST https://api.doc.cheap/v1/scans \
-H "Authorization: Bearer sk_sandbox_public" \
-H "Content-Type: application/json" \
-d "{\"image\": \"$(base64 < document.jpg | tr -d '\n')\"}"Diese Seite behandelt, was für das Ausstellungsland Deutschland spezifisch ist. Die vier Seiten unten (auf Englisch) enthalten alles Übrige.
Der Aufruf von oben mit einem echten Dokument, in curl, JavaScript und Python, und jeder Schlüssel der Antwort erklärt.
Warum ein Dokument dieselben Angaben zweimal druckt, welcher Zone man glauben sollte, wenn sie sich widersprechen, und was die Prüfziffern oben beweisen können und was nicht.
Die Zone ist eine lateinische Transliteration, die Sichtzone nicht. Welche Lesung die Originalschrift trägt und wie eine Sprachkennung zu einer Sprache aufgelöst wird.
Jeder Fehlercode, mit dem die API antworten kann, in einer Tabelle: was ihn auslöst, ob ein erneuter Versuch gelingen kann und ob der Aufruf berechnet wurde.
Erster erfolgreicher Aufruf in weniger als 60 Sekunden, 1¢ pro Dokument, und das Bild des Dokuments wird nie gespeichert.
Sie zahlen nur für Dokumente, die wir tatsächlich erkennen.
Unscharfes Foto, kein Dokument im Bild, unbekannter Typ – kostenlos. Für einen fehlgeschlagenen Scan zahlen Sie nie.