Analyse des passeports avec l'API de Mindee

De nombreux processus d'intégration dans les applications mobiles ou Web nécessitent l'extraction de certaines données à partir de documents d'identité. Dans ce didacticiel, vous allez apprendre à extraire automatiquement les données des passeports afin d'offrir à vos utilisateurs la meilleure expérience d'intégration possible.

Nous allons vous expliquer les étapes à suivre pour utiliser l'API d'analyse des passeports internationaux de Mindee. Allons-y !

Prérequis de l'API

1. Vous aurez besoin d'un compte Mindee gratuit. INSCRIVEZ-VOUS et confirmez votre adresse e-mail pour vous connecter.
2. Une photo de passeport. Vous pouvez utiliser les vôtres en toute sécurité car la protection des données est l'une de nos priorités et nous n'enverrons vos images à aucune application tierce. Vous pouvez également en télécharger un faux directement sur l'application Mindee.

Configuration de l'API

Connectez-vous à votre compte Mindee et accédez à l'environnement API de votre passeport en cliquant sur International Passeport carte :

Pour activer l'API, cliquez sur le bouton « Essayer gratuitement ». Cela vous permettra d'accéder à l'API gratuitement 50 fois par mois. La page d'accueil de l'API comporte quatre sections, indiquées dans la navigation de gauche. Vous êtes actuellement sur le tableau de bord et vous trouverez des liens supplémentaires vers « Documentation », « Informations d'identification » et « Interface dynamique ». L'onglet Documents contient tous les détails techniques dont vous aurez besoin pour créer pour le point de terminaison de l'API Passports, et l'interface en direct est une démonstration interactive intéressante.

Nous allons commencer par cliquer sur « informations d'identification » et créer un nouveau jeton d'API, dans ce cas, nommé Tutorial :

Cliquez sur « Ajouter une nouvelle clé » et vous pourrez voir votre jeton d'API.

Si vous revenez à l'onglet de documentation, vous pouvez choisir votre jeton d'API et la langue, puis créer un appel d'API. Voici l'appel d'API dans 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

Il suffit de remplacer {Token API} avec votre nouveau jeton d'API et /chemin/vers/votre/fichier/png avec le chemin d'accès à votre reçu.

C'est ça ! Nous sommes prêts à exécuter cette commande dans le terminal et à voir les données que Mindee peut extraire.

Dans ce tutoriel, j'utiliserai un exemple de [passeport chypriote] (https://commons.wikimedia.org/wiki/File:Cyprus\_passport\_data\_page.webp) de Wikimedia.

La réponse JSON peut être un peu détaillée, nous allons donc la diviser en sections pour décrire ce que nous voyons. Les sections initiales décrivent l'API et la réponse de l'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"
}],

Ici, nous pouvons voir que l'API Passport a été appelée et qu'elle a traité un document en 2 secondes environ. Ce qui nous intéresse vraiment, ce sont les résultats, qui se trouvent dans la section des prédictions du fichier JSON :

Prédictions

La réponse de l'API est classée par ordre alphabétique des éléments extraits du document :

Date de naissance

"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"
},

L'API a fait correspondre la date de naissance dans les champs MRX (nous y reviendrons dans une minute). Elle est donc sûre à 100 % que la date de naissance est le 1er janvier 1970. Le cadre de délimitation indique quatre points (x, y) sur l'image où se trouve la date de naissance.

Pays d'émission

L'API tente ensuite d'analyser le pays qui a délivré le passeport.

"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"
},

L'API est certaine à 99 % que Chypre est le pays émetteur. C'est vraiment incroyable, car l'équipe de l'API m'a dit qu'il n'y avait aucun passeport chypriote dans l'ensemble de données de formation. Encore une fois, les coordonnées 4 (x, y) de l'image indiquent où CYP est utilisé.

Date d'expiration

"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"
},

De nombreux pays n'autorisent pas l'entrée si la durée de validité du passeport est inférieure à six mois. Cette femme devrait probablement entamer le processus de renouvellement, car l'API a identifié que ce passeport expirera le 1er décembre 2020.

Genre

"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 confiance de l'API n'est pas élevée sur ce point, seulement 10 %, mais elle identifie correctement le sexe comme étant féminin.

Prénom

"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"
}],

L'API est vraiment certaine (99 % de confiance) que le prénom sur le passeport est Afroditi, ce qui signifie que le titulaire de notre passeport a été nommé d'après la déesse grecque de la beauté et de l'amour.

Numéro d'identification

"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"
},

Bien que nous ne soyons pas des numéros, à bien des égards, nous sommes identifiés par des chiffres. Dans ce cas, le numéro d'identification du passeport, qui doit être utilisé lors de la réservation de vols, de l'enregistrement dans les hôtels, etc. L'API a trouvé l'emplacement (marqué par les 4 points (x, y) dans le cadre de délimitation, pour le numéro de passeport, qui est K00000413.

Date d'émission

Poursuivant le voyage alphabétique dans les champs du passeport, nous arrivons ensuite à la date de délivrance du passeport :

"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"
},

Dans ce cas, l'API n'a pas atteint la date d'émission. Cependant, bien que notre API ne figure pas dans ses prévisions, dans ce cas, le problème est dû au fait que le passeport est un échantillon (nous publierons bientôt un article de blog à ce sujet). La date d'émission est absente de la zone MRZ de l'échantillon de passeport, de sorte que l'API n'est pas en mesure de mesurer avec précision la date d'émission.

Prénom

"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"
}

Notre faux titulaire de passeport porte le nom de famille Anonymou, qui est correctement identifié par l'API, ainsi que des encadrés.

MRZ1 et MRZ2

Les deux dernières régions identifiées par l'API (que j'ai *légèrement* par ordre alphabétique pour des raisons de lisibilité) sont les 2 lignes MRZ (Machine Readable Zone) :

"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

Les zones MRZ (si vous ne pouvez pas les distinguer à partir du JSON ci-dessus) sont les deux lignes de texte lisibles par machine au bas de chaque page de passeport. MRZ1 est la ligne 1 et MRZ2 est la ligne 2. La plupart des informations d'identification peuvent être extraites de cette zone. L'intervalle de confiance pour la première ligne est élevé, car cette zone est correctement remplie sur le faux passeport. Cependant, le niveau de confiance est faible, car l'algorithme prévoyait un plus grand nombre de caractères autres que « < » pour fournir la date d'émission.

Conclusion

Et voilà ! L'API de passeport de Mindee a analysé un passeport en moins de 2 secondes, faisant correspondre presque toutes les sections du passeport rapidement et avec précision. Essayez-le avec notre offre gratuite et dites-nous dans le chat comment cela fonctionne pour vous !