Análisis de pasaportes con la API de Mindee

Muchos procesos de incorporación en aplicaciones móviles o web requieren extraer datos de documentos de identidad. En este tutorial, aprenderá cómo extraer automáticamente datos de pasaportes para ofrecer a sus usuarios la mejor experiencia de incorporación.

Recorreremos los pasos para usar la API de análisis de pasaportes internacionales de Mindee. ¡Empecemos!

Requisitos previos de la API

1. Necesitará una cuenta gratuita de Mindee. Registrarse y confirme su correo electrónico para iniciar sesión.
2. Una foto de un pasaporte. Puede usar el suyo de forma segura, ya que la protección de datos es una de nuestras prioridades y no enviaremos sus imágenes a ninguna aplicación de terceros. También puede descargar uno falso directamente desde la aplicación de Mindee.

Configuración de la API

Inicie sesión en su cuenta de Mindee y acceda a su entorno de API de pasaportes haciendo clic en la International Passport tarjeta:

Para activar la API, haga clic en el botón “Probar gratis”. Esto le dará acceso gratuito a la API 50 veces al mes. Hay cuatro secciones en la página de inicio de la API, indicadas en la navegación izquierda. Actualmente se encuentra en el panel de control, y hay enlaces adicionales a “Documentación”, “Credenciales” e “Interfaz en vivo”. La pestaña de documentación contiene todos los detalles técnicos que necesitará para construir el endpoint de la API de pasaportes, y la Interfaz en vivo es una demostración interactiva genial.

Comenzaremos haciendo clic en “credenciales” y creando un nuevo token de API, en este caso, llamado Tutorial:

Haga clic en “Añadir nueva clave” y podrá ver su token de API,.

Si vuelve a la pestaña de documentación, puede seleccionar su token de API y el idioma, y crear una llamada a la API. Aquí está la llamada a la API en cURL:

curl -X POST \ https://api.mindee.net/products/passport/v1/predict \ -H 'X-Inferuser-Token: {apiToken}' \ -H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \ -F file=@/path/to/your/file.png

Simplemente reemplace {apiToken} con tu nuevo token de API y /path/to/your/file/png con la ruta a tu recibo.

¡Eso es todo! Estamos listos para ejecutar este comando en la terminal y ver los datos que Mindee puede extraer.

En este tutorial, usaré un pasaporte de Chipre de ejemplo (https://commons.wikimedia.org/wiki/File:Cyprus\_passport\_data\_page.webp) de Wikimedia.

La respuesta JSON puede ser un poco extensa, así que la dividiremos en secciones para describir lo que estamos viendo. Las secciones iniciales describen la API y la respuesta de la API:

"call": {
	"endpoint": {
		"name": "passport",
		"version": "1.0"
	},
	"finished_at": "2020-09-04T20:57:51+00:00",
	"id": "7d81f5fe-fce1-4b63-b3de-cc5948c39b55",
	"n_documents": 1,
	"n_inputs": 1,
	"processing_time": 1.988,
	"started_at": "2020-09-04T20:57:49+00:00"
}, "documents": [{
	"id": "57aded44-a216-45be-859c-f949cc5b011d",
	"name": "1024px-Cyprus_passport_data_page.jpg"
}],

Aquí, podemos ver que se llamó a la API de pasaportes y procesó un documento en aproximadamente 2 segundos. Lo que realmente nos interesa ver son los resultados, y estos se pueden encontrar en la sección de predicciones del archivo JSON:

Predicciones

La respuesta de la API está en orden alfabético de los elementos extraídos del documento:

Fecha de nacimiento

"birth_date": {
	"probability": 1.0,
	"segmentation": {
		"bounding_box": [
			[.053, 0.912],
			[0.955, 0.912],
			[0.955, 0.969],
			[0.053, 0.969]
		]
	},
	"value": "1970-01-01"
},

La API coincidió con la fecha de nacimiento en los campos MRX (más sobre esto en un minuto), por lo que está 100% segura de que la fecha de nacimiento es el 1 de enero de 1970. El cuadro delimitador proporciona cuatro puntos (x,y) en la imagen donde se puede encontrar la fecha de nacimiento.

País de emisión

La API intenta entonces analizar el país que emitió el pasaporte.

"country": {
	"probability": 0.99,
	"segmentation": {
		"bounding_box": [
			[0.479, 0.199],
			[0.522, 0.199],
			[0.522, 0.234],
			[0.479, 0.234]
		]
	},
	"value": "CYP"
},

La API está 99% segura de que Chipre es el país emisor. Esto es realmente increíble, ya que el equipo de la API me dice que no hay pasaportes de Chipre en el conjunto de datos de entrenamiento. De nuevo, 4 coordenadas (x,y) en la imagen señalan dónde se utiliza CYP.

Fecha de caducidad

"expiry_date": {
	"probability": 1.0,
	"segmentation": {
		"bounding_box": [
			[0.053, 0.912],
			[0.955, 0.912],
			[0.955, 0.969],
			[0.053, 0.969]
		]
	},
	"value": "2020-12-01"
},

Muchos países no permiten la entrada con menos de seis meses de validez restantes en el pasaporte. Esta mujer debería probablemente iniciar el proceso de renovación, ya que la API ha identificado que este pasaporte caducará el 1 de diciembre de 2020.

Género

"gender": {
	"probability": 0.1,
	"segmentation": {
		"bounding_box": [
			[0.053, 0.912],
			[0.955, 0.912],
			[0.955, 0.969],
			[0.053, 0.969]
		]
	},
	"value": "F"
},

La confianza de la API no es alta en este caso, solo del 10%, pero identifica correctamente el género como femenino.

Nombre de pila

"given_names": [{
	"probability": 0.99,
	"segmentation": {
		"bounding_box": [
			[0.048, 0.844],
			[0.952, 0.844],
			[0.952, 0.895],
			[0.048, 0.895]
		]
	},
	"value": "AFRODITI"
}],

La API está realmente segura (99% de confianza) de que el nombre de pila en el pasaporte es Afroditi, lo que significa que el titular de nuestro pasaporte fue nombrado en honor a la diosa griega de la belleza y el amor.

Número de identificación

"id_number": {
	"probability": 1.0,
	"segmentation": {
		"bounding_box": [
			[0.673, 0.197],
			[0.774, 0.197],
			[0.774, 0.233],
			[0.673, 0.233]
		]
	},
	"value": "K00000413"
},

Aunque no somos números, en muchos sentidos, nos identificamos por números. En este caso, el número de identificación del pasaporte, que debe usarse al reservar vuelos, registrarse en hoteles, etc. La API ha encontrado la ubicación (marcada por los 4 puntos (x,y) en el cuadro delimitador) del número de pasaporte, que es K00000413.

Fecha de emisión

Continuando el recorrido alfabético por los campos del pasaporte, llegamos a la fecha de emisión del pasaporte:

"issuance_date": {
	"probability": 0.18,
	"segmentation": {
		"bounding_box": [
			[0.353, 0.586],
			[0.426, 0.586],
			[0.426, 0.62],
			[0.353, 0.62]
		]
	},
	"value": "2014-01-21"
},

En este caso, la API no detectó la fecha de emisión. Sin embargo, aunque nuestra API sí comete errores en sus predicciones, en este caso, el problema se debe a que el pasaporte es una muestra (pronto publicaremos una entrada de blog al respecto). La fecha de emisión falta en la zona MRZ del pasaporte de muestra, por lo que la API no puede determinar con precisión la fecha de emisión.

Apellido

"surname": {
	"probability": 0.98,
	"segmentation": {
		"bounding_box": [
			[0.33, 0.272],
			[0.444, 0.272],
			[0.444, 0.309],
			[0.33, 0.309]
		]
	},
	"value": "ANONYMOU"
}

El titular de nuestro pasaporte ficticio tiene el apellido Anonymou, que es identificado correctamente por la API, junto con los cuadros delimitadores.

MRZ1 y MRZ2

Las dos últimas regiones identificadas por la API (que he sacado *ligeramente* del orden alfabético para facilitar la lectura) son las 2 líneas de la Zona de Lectura Mecánica (MRZ):

"mrz1": {
	"probability": 0.99,
	"segmentation": {
		"bounding_box": [
			[0.048, 0.844],
			[0.952, 0.844],
			[0.952, 0.895],
			[0.048, 0.895]
		]
	},
	"value": "P

Las zonas MRZ (si no lo puedes deducir del JSON anterior) son las dos líneas de texto de lectura mecánica en la parte inferior de cada página del pasaporte. MRZ1 es la línea uno, y MRZ2 es la línea 2. La mayor parte de la información de identificación se puede extraer de esta área. El intervalo de confianza para la línea uno es alto, ya que el pasaporte ficticio tiene esta área rellenada correctamente. Sin embargo, el nivel de confianza es bajo, ya que el algoritmo esperaba más caracteres además de “<” para proporcionar la fecha de emisión.

Conclusión

¡Así de fácil! La API de pasaportes de Mindee analizó un pasaporte en menos de 2 segundos, coincidiendo con casi todas las secciones del pasaporte de forma rápida y precisa. ¡Pruébala con nuestro nivel gratuito y cuéntanos en el chat cómo te funciona!