Envía una foto de un pasaporte de Estados Unidos y recibe los datos estructurados en la misma respuesta HTTP: la zona de lectura mecánica (MRZ) analizada, los dígitos de control ICAO 9303 verificados y los campos visuales extraídos. Sin SDK que instalar ni cola que consultar.
Un pasaporte de Estados Unidos sigue la norma ICAO 9303: una zona de lectura mecánica de dos líneas de 44 caracteres (formato TD3) impresa al pie de la página de datos, debajo de la zona de inspección visual que lee una persona. Sus cinco primeros caracteres son P<USA: el código del documento y, después, el Estado emisor con el código ISO 3166-1 alfa-3 USA. La API lee las dos zonas, contrasta los dígitos de control de la MRZ y devuelve una única forma de respuesta con todas las claves presentes.
Estados Unidos es US en una lista alfa-2 y USA en la zona: aquí el código largo es el corto seguido de A. Eso se cumple en este par y no como regla, así que derivar uno del otro es un error a la espera del primer país en el que no encaje.
La norma 9303 define tres diseños de zona, y la API lee los tres. Abajo aparece una titular inventada (no es nadie, y paradeigma es la palabra griega para ejemplo) en cada diseño, con USA como Estado emisor. Cada dígito de control se calcula a partir de los caracteres que lo acompañan en lugar de escribirse a mano, así que todas las zonas de esta página validan.
2 líneas de 44. Nacionalidad USA. El Estado emisor y la nacionalidad son ambos USA: un pasaporte certifica la nacionalidad del Estado que lo emite.
P<USAPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184USA9403084F3203101PN48291630<<<<722 líneas de 36. Nacionalidad GRC. Emitido por USA a una persona de nacionalidad GRC, así que los dos códigos difieren. Aquí el nombre tiene 31 caracteres en lugar de los 39 del pasaporte.
I<USAPARADEIGMA<<ELENI<SOFIA<<<<<<<<
TR61850420GRC9403084F2911043<<<<<<<23 líneas de 30. Nacionalidad GRC. Tres líneas de 30, con el nombre en una línea propia. El código del documento es ID: la parte 5 de la 9303 fija el primer carácter como A, C o I y deja el segundo al Estado emisor.
IDUSAAK472913<4PN48291630<<<<<
9403084F3405204GRC<<<<<<<<<<<9
PARADEIGMA<<ELENI<SOFIA<<<<<<<Ningún dígito de control cubre al Estado emisor: en los tres diseños la aritmética recorre el número del documento, las fechas y los datos opcionales, nunca los tres caracteres que dicen quién lo emitió. Una zona cuyos dígitos pasan todos no ha demostrado que venga de Estados Unidos: eso lo hacen la zona visual y las medidas de seguridad del propio documento.
Pega una MRZ en el analizador de MRZ para validar sus dígitos de control, o crea una con el generador de MRZ.
Cada pasaporte de Estados Unidos reconocido devuelve los mismos campos estructurados. Un valor que no se pudo leer es null, nunca una clave ausente.
Consulta todos los campos en el explorador de campos del documento (en inglés).
Ejecuta esto contra el sandbox público: sin registro, con reconocimiento real, gratis para un número limitado de documentos y 10 solicitudes por hora por IP. Cambia la clave del sandbox por tu propia clave de producción para seguir reconociendo pasaportes de Estados Unidos.
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')\"}"Esta página cubre lo que es propio de Estados Unidos. Las cuatro páginas de abajo (en inglés) recogen todo lo demás.
La llamada de arriba con un documento real, en curl, JavaScript y Python, y cada clave de la respuesta explicada.
Por qué un documento imprime los mismos datos dos veces, a qué zona creer cuando no coinciden y qué pueden y qué no pueden demostrar los dígitos de control.
La zona es una transliteración latina; la zona visual no. Qué lectura conserva la escritura original y cómo se resuelve un identificador de idioma.
Cada código de error con el que puede responder la API, en una tabla: qué lo causa, si un reintento puede funcionar y si la llamada se cobró.
Primera llamada correcta en menos de 60 segundos, 1¢ por documento, y la imagen del documento nunca se guarda.
Solo pagas los documentos que realmente reconocemos.
Foto borrosa, ningún documento en el encuadre, tipo desconocido: gratis. Nunca pagas un escaneo fallido.