Reisepass-OCR-API für das Ausstellungsland Vereinigte Staaten

So wird ein Reisepass mit dem Ausstellungsland Vereinigte Staaten erkannt

Ein Reisepass mit dem Ausstellungsland Vereinigte Staaten 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<USA – der Dokumentcode, dann der ausstellende Staat als ISO-3166-1-Alpha-3-Code USA. 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 US, in der Zone USA (Vereinigte Staaten): In diesem Fall ist der längere Code der kürzere mit A 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.

Maschinenlesbare Zonen mit dem Ausstellungsland Vereinigte Staaten

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 USA als ausstellendem Staat. Jede Prüfziffer wird aus den Zeichen daneben berechnet statt eingetippt, daher ist jede Zone hier gültig.

P<USAPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184USA9403084F3203101PN48291630<<<<72

I<USAPARADEIGMA<<ELENI<SOFIA<<<<<<<<
TR61850420GRC9403084F2911043<<<<<<<2

IDUSAAK472913<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 Vereinigte Staaten 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.

Die Felder, die Sie zurückbekommen

Jeder erkannte Reisepass mit dem Ausstellungsland Vereinigte Staaten liefert dieselben strukturierten Felder. Ein Wert, der nicht gelesen werden konnte, ist null, nie ein fehlender Schlüssel.

• Nachname und Vornamen
• Geburtsdatum und Geschlecht
• Dokumentnummer und persönliche Nummer
• Staatsangehörigkeit und ausstellender Staat (USA)
• Ausstellungs- und Ablaufdatum, verbleibende Tage
• Das MRZ-Urteil und die Zeilen, aus denen es gelesen wurde

Alle Felder finden Sie im Dokumentfeld-Explorer (auf Englisch).

Den Aufruf ausführen

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 Vereinigte Staaten 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')\"}"

Wo das dokumentiert ist

Diese Seite behandelt, was für das Ausstellungsland Vereinigte Staaten spezifisch ist. Die vier Seiten unten (auf Englisch) enthalten alles Übrige.

• Einen Reisepass erkennen

  Der Aufruf von oben mit einem echten Dokument, in curl, JavaScript und Python, und jeder Schlüssel der Antwort erklärt.

• Die MRZ und die Sichtzone

  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.

• Sprachen und Schriften der Felder

  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.

• Fehler

  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.