Une API pour mon API ?

Le week-end dernier, les enfants et moi sommes montés dans la voiture pour une longue excursion d'une journée. J'ai conduit la voiture quelques heures vers le sud jusqu'à Folkestone, au Royaume-Uni. Nous avons fait examiner nos passeports et, après une courte attente, j'ai pris le train avec notre voiture. Alors que nous étions encore dans la voiture. 30 minutes plus tard, le train s'est arrêté à Calais et nous étions en France.

Le service s'appelle Eurotunnel, et c'est un moyen facile d'amener votre voiture avec la conduite à droite en Europe et de conduire sur le côté droit de la route (ou une voiture avec conduite à gauche pour conduire sur le côté gauche au Royaume-Uni).

Départ du train Eurotunnel. Photo prise par ma fille.

Dans notre cas, nous avons littéralement fait deux ronds-points, puis nous avons pris le train pour rentrer au Royaume-Uni (c'est une étrange question de visa, probablement mieux que vous ne le demandiez pas :))

Qu'est-ce que tout cela a à voir avec les API ?

Bon sang, je suis content que tu l'aies demandé, mais j'étais en train d'y arriver... vraiment.

Lorsque vous réservez un voyage à bord de l'Eurotunnel, vous vous rendez sur EuroTunnel.com et vous entrez vos dates de voyage et la plaque d'immatriculation de votre voiture. Ils utilisent une API pour rechercher la marque et le modèle de votre voiture, afin de déterminer le coût de votre voyage. (Nous avons une grande camionnette, nous avons donc dû nous rendre dans la section des voitures surdimensionnées). Tu vois, là. J'ai parlé d'une API !

Vous choisissez vos dates et vos heures de départ, comme si vous choisissiez un vol (vous vous souvenez quand nous pouvions réserver un vol et prendre des vacances ?). Vous voyez le prix, entrez votre numéro de carte et vous vous retrouvez sur une page de réussite ! Hourra, vous partez pour la France !

Pas si vite

Un peu plus tard, vous consultez vos e-mails et vous voyez l'e-mail de confirmation d'Eurotunnel. En haut, il vous indique les horaires et vous indique que vous devez vous rendre au terminal 45 minutes avant le départ... bla bla bla. Il existe une section sur les voyages pendant le coronavirus, que vous pourriez consulter.

Si vous êtes toujours dans l'e-mail, mais avant d'accéder au bouton « Suivez Eurotunnel sur Twitter », une section a attiré mon attention :

Assurez-vous que votre API est complète

Oh, comme un Spécification de l'API ouverte — assurez-vous que mon API est complète... Ensuite, je me rappelle que je ne lis pas un e-mail professionnel, mais mon itinéraire de voyage pour prendre le train avec ma voiture.

« Si vous ne fournissez pas votre API avant le voyage », cela semble étrangement spécifique. Encore une fois, je parie que la plupart des gens n'ont pas leur propre API.

« Ajoutez une API à votre réservation ». Est-ce que c'est comme un challenge de hackathon ? Eurotunnel remboursera-t-il une partie de mon billet si je construis quelque chose de cool ? Très bien, je vais vraiment cliquer sur ce lien !

J'arrive sur une page Web qui ressemble à un clickbait étrange et fou pour les développeurs.

Besoin d'aide pour remplir votre API — Oui ! Oui, je le sais ! Allez-vous fournir de superbes jetons d'API ou quelque chose comme ça ?

L'API est devenue plus facile Génial. Existe-t-il une intégration Zapier dont je peux tirer parti pour connecter votre API ? M'aideras-tu à devenir RESTful ?

Oui, c'est bien moins cool que ça

Pour les développeurs, API signifie interface de programmation d'applications. Ce que voulait vraiment Eurotunnel, c'était :

Informations préalables sur les passagers ? Boiteux.

La capture d'écran ci-dessus (avec la case verte joyeuse) est à quoi elle ressemble APRÈS vous ajoutez votre API. Au préalable, tout le texte est rouge, sur fond rose, et il vous avertit que sans ajouter votre API, vous risquez de ne pas passer la billetterie, ou que le contrôle des frontières pourrait ne pas vous laisser monter dans le train. Ou qu'ils vous laisseront monter dans le train, mais ne vous laisseront jamais descendre... Je ne me souviens pas de tous les détails, mais les conséquences ont été désastreuses.

Inutile de dire que j'ai fourni mon API. Et il s'avère que tout ce qu'ils voulaient, c'était les informations de mon passeport.

Prénom, nom de famille, nationalité,

numéro de passeport,

Date de naissance,

Expiration du passeport.

Vous savez, les informations que nous avions l'habitude de remplir sur les sites de réservation de voyages, à l'époque où nous pouvions voyager à l'étranger.

Cela m'a fait réfléchir

Si vous avez déjà postulé pour un emploi en ligne, vous savez que vous téléchargez votre CV et que le site Web scanne tout le texte et saisit automatiquement votre nom, votre adresse, votre e-mail et toutes vos informations d'expérience dans un formulaire détaillé que vous pouvez ensuite envoyer à une boîte aux lettres que personne ne surveille.

C'est plutôt cool que les ordinateurs puissent lire l'intégralité de votre CV et ensuite vous ignorer.

Mais pourquoi les compagnies aériennes (ou l'Eurotunnel) ne peuvent-elles pas prendre une photo de mon passeport et extraire toutes ces données de passeport standard pour moi (et mes enfants) ? Pourquoi ai-je rempli un formulaire en ligne pour chaque vol (pour tous ceux qui voyagent), alors que le simple fait de télécharger une image aurait pu accomplir exactement la même chose ?

L'API Passport existe

Mindee.com dispose d'une API d'extraction de passeports. Il y a un tutoriel sur la façon de l'utiliser sur leur site web (et si vous vous inscrivez, il y a une démo en direct que vous pouvez tester gratuitement. En gros, vous téléchargez une photo de votre page de photo d'identité sur leur point de terminaison API, et toutes les informations souhaitées seront extraites dans un objet JSON.

L'algorithme vous propose également des cadres de délimitation autour de l'emplacement des informations, ce qui vous permet de créer des images comme celle-ci (il s'agit de la démonstration en direct sur la page de l'API) :

C'est un faux passeport.

Vous obtenez également un joli formulaire avec tous les champs extraits :

Pays, numéro de passeport et nom, tous extraits automatiquement de l'image.

Une API pour mon API !

Ma famille voyage peut-être plus que d'habitude, mais j'ai des images des passeports de tous les membres de ma famille enregistrées sur mon ordinateur. Imaginez à quel point l'enregistrement serait facile si je pouvais simplement télécharger 6 images et que le site Web puisse renseigner toutes les dates de passeport (délivrance, expiration, date de naissance), le numéro de passeport et le nom de chaque voyageur.

Il y aurait probablement moins d'erreurs pour Eurotunnel, et ce serait beaucoup plus rapide et plus facile pour ses utilisateurs.

Puis je me suis dit... et si toutes les compagnies aériennes faisaient ça ? Donnez une option aux gens. « Remplissez ce formulaire ou téléchargez une photo de votre passeport » (Cela ressemble à la façon dont vous pourriez postuler à un emploi sur LinkedIn, amirite ?) Cela simplifierait l'ensemble du processus pour les clients !

Conseil de pro : Ryanair : vous pourriez même proposer le téléchargement automatique de votre passeport en tant que « module complémentaire » (pour 1,50€ par voyageur, souhaitez-vous télécharger votre passeport plutôt que de saisir les valeurs manuellement ?)

La saisie manuelle des données est nulle

Pourquoi TOUTES les agences de voyages du monde ne proposent-elles pas cela ? Ce n'est pas une question de sécurité : de nombreuses portes de contrôle des passeports examinent la photo d'identité et décident si vous êtes automatiquement autorisé à entrer dans le pays ou non. Cela devrait être une évidence pour TOUS les sites de voyage du monde.

Conclusion

Ma blague initiale sur l'utilisation des API pour la saisie des données de passeport m'a permis de rechercher une API capable d'analyser automatiquement les données de passeport. J'ai trouvé celui de Mindee et je l'ai trouvé très facile à mettre en œuvre. De telles solutions accéléreront le processus d'enregistrement, réduiront le nombre d'erreurs et faciliteront la tâche des clients. J'ai hâte de le voir en service en 2021, la prochaine fois que je prévois de voyager à l'étranger.