AusweisCheck Library

AusweisCheck ist eine Library für PHP und JavaScript um mit wenige Zeilen die Echtheit eines Ausweises zu überprüfen. Es lassen sich Deutsche Personalausweise überprüfen, oder alternativ Internationale Reisepässe inklusive der Nationalität.

ausweischeck.min.js ist nur 2 KB groß und braucht zur überprüfung nur eine einzige Code Zeile!

Beispiele

Für alle Sprachen gibt es im Ordner examples Beispiele für die Nutzung. PHP ist nur auf einem eigenem Server ausführbar, Die JavaScript kann hier getestet werden:

https://cdn.rawgit.com/derDeno/AusweisCheck/1cdb9697/example/index-js.html

Beispiel Nummern:

Personalausweis: T220001293

Reisepass: 1220001297D

Nutzung

Benötigt wird immer die Seriennummer des Ausweises mit der Prüfziffer am Ende bzw. mit dem Länderkürzel beim Reisepässen. Beim Perso ist diese Nummer auf der Rückseite in der ersten Zeile nach IDD zu finden. Die länge der Seriennummer inkl. Prüfziffer ist 10 Zeichen. Beim Reisepass ist sie auch ganz unten in der zweiten Zeile zu finden. Die länge der Seriennummer inkl. Prüfziffer und Länderkennung ist min. 11 Zeichen lang max. 13 Zeichen (manche Länder haben nur ein Buchstaben andere drei).

JavaScript

Wenn die Ausweisnummer durch ein Formular oder ähnliches schon vorhanden ist:

var check = new AusweisCheck(ausweisnummer).checkPerso;

oder für einen Internationalen Reisepass:

var check = new AusweisCheck(ausweisnummer).checkReisepass;

wobei ausweisnummer die zu überprüfende Ausweisnummer ist. Als Antwort liefern beide Funktionen 3 Möglichkeiten:

False Die Variable check aus unserem Beispiel hat den Wert false. Das bedeutet das die Ausweisnummer nicht vollständig ist / zu kurz ist.

Array true Ist die Ausweisnummer gültig ist die Variable check aus dem Beispiel ein Array das so aussieht:

array (
"check" => true,
"ausweisnummer" => "1234567890",
"type" => "Personalausweis" oder "Reisepass"
"nation" => "D" // nur bei Reisepass
);

Dieses Array liefert nicht nur das Ergebnis sondern auch andere nützliche Informationen zur Weiterverarbeitung.

Array false Ist die Ausweisnummer ungültig ist die Variable check aus unserem Beispiel ein Array das so aussieht:

array (
"check" => false,
"error" => "Prüfsumme stimmt nicht überein"
);

PHP

DIe PHP Version ist in großen Teilen identisch wie die Javascript Version aufgebaut. Wenn die Ausweisnummer schon bekannt ist:

$as = new AusweisCheck();
$check = $as->Personalausweis($ausweisnummer);

oder bei einem Internationalen Reisepass

$as = new AusweisCheck();
$check = $as->Reisepass($ausweisnummer);

wobei $ausweisnummer die zu überprüfende Ausweisnummer ist. Als Antwort liefern beide Funktionen 3 Möglichkeiten:

False Die Variable $check aus unserem Beispiel hat den Wert false. Das bedeutet das die Ausweisnummer nicht vollständig ist / zu kurz ist.

Array true Ist die Ausweisnummer gültig ist die Variable check aus dem Beispiel ein Array das so aussieht:

array (
"check" => true,
"ausweisnummer" => "1234567890",
"type" => "Personalausweis" oder "Reisepass"
"nation" => "D" // nur bei Reisepass
);

Dieses Array liefert nicht nur das Ergebnis sondern auch andere nützliche Informationen zur Weiterverarbeitung.

Array false Ist die Ausweisnummer ungültig ist die Variable check aus unserem Beispiel ein Array das so aussieht:

array (
"check" => false,
"error" => "Prüfsumme stimmt nicht überein"
);

Sonstiges

Bei Fragen oder Anregungen einfach ein neues Issue öffnen!

Changelog

Version 0.0.1:

Inital Release