API OCR de passeports – États-Unis

Reconnaître un passeport – États-Unis

Le passeport de ce pays (États-Unis) suit la norme ICAO 9303 : une zone de lecture automatique de deux lignes de 44 caractères (format TD3) imprimée au bas de la page de données, en complément de la zone d’inspection visuelle destinée à l’œil humain. Ses cinq premiers caractères sont P<USA – le code du document, puis l’État émetteur sous la forme du code ISO 3166-1 alpha-3 USA. L’API lit les deux zones, recoupe les chiffres de contrôle de la MRZ et renvoie une seule structure de réponse où toutes les clés sont présentes.

États-Unis : US dans une liste alpha-2 et USA dans la zone. Ici, le code long est le code court suivi de A. C’est vrai pour cette paire, pas en règle générale : déduire l’un de l’autre est un bug qui attend le premier pays auquel la règle ne s’applique pas.

Zones de lecture automatique – État émetteur : États-Unis

La norme 9303 définit trois dispositions de zone, et l’API lit les trois. Ci-dessous, une même titulaire inventée – elle n’existe pas, et paradeigma est le mot grec pour exemple – dans chaque disposition, avec USA comme État émetteur. Chaque chiffre de contrôle est calculé à partir des caractères qui l’entourent au lieu d’être saisi à la main, si bien que chaque zone de cette page est valide.

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

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

IDUSAAK472913<4PN48291630<<<<<
9403084F3405204GRC<<<<<<<<<<<9
PARADEIGMA<<ELENI<SOFIA<<<<<<<

Aucun chiffre de contrôle ne couvre l’État émetteur : dans les trois dispositions, le calcul porte sur le numéro du document, les dates et les données facultatives, jamais sur les trois caractères qui disent qui a émis le document. Une zone dont tous les chiffres sont valides n’a pas prouvé qu’elle provient de ce pays (États-Unis) – ce sont la zone visuelle et les éléments de sécurité du document lui-même qui le font.

Collez une MRZ dans l’analyseur MRZ pour valider ses chiffres de contrôle, ou créez-en une avec le générateur MRZ.

Les champs que vous recevez

Chaque passeport reconnu de ce pays (États-Unis) renvoie les mêmes champs structurés. Une valeur qui n’a pas pu être lue vaut null, jamais une clé absente.

• Nom et prénoms
• Date de naissance et sexe
• Numéro du document et numéro personnel
• Nationalité et État émetteur (USA)
• Dates de délivrance et d’expiration, jours restants
• Le verdict de la MRZ, et les lignes lues

Découvrez tous les champs dans l’explorateur de champs du document.

Faites l’appel

Exécutez ceci sur le sandbox public – sans inscription, avec une vraie reconnaissance, gratuite pour un nombre limité de documents et 10 requêtes par heure et par IP. Remplacez la clé du sandbox par votre propre clé de production pour continuer à reconnaître des passeports de ce pays (États-Unis).

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

Où c’est documenté

Cette page couvre ce qui est propre à ce pays (États-Unis). Les quatre pages ci-dessous (en anglais) couvrent tout le reste.

• Reconnaître un passeport

  L’appel ci-dessus avec un vrai document, en curl, JavaScript et Python, et chaque clé de la réponse expliquée.

• La MRZ et la zone visuelle

  Pourquoi un document imprime deux fois les mêmes informations, quelle zone croire quand elles ne concordent pas, et ce que les chiffres de contrôle peuvent et ne peuvent pas prouver.

• Langues et écritures des champs

  La zone est une translittération latine ; la zone visuelle, non. Quelle lecture conserve l’écriture d’origine, et comment un identifiant de langue se résout en une langue.

• Erreurs

  Chaque code d’erreur que l’API peut renvoyer, dans un seul tableau : ce qui le cause, si une nouvelle tentative peut réussir, et si l’appel a été facturé.