Certaines sociétés de transport ont investi dans leur propre application pour leurs chauffeurs. Leur demander d’en ouvrir une seconde pour vos usagers, c’est deux écrans au volant, deux habitudes et des oublis de pointage. L’API transport adapté pour application mobile de NavigoMédic évite ce doublon : l’application du transporteur récupère les tournées du jour et renvoie les pointages, qui arrivent dans votre établissement exactement comme s’ils venaient de notre propre application.
À qui s’adresse l’API, et à qui elle ne sert pas
Dans la grande majorité des cas, l’API n’est pas nécessaire. Les chauffeurs utilisent l’application chauffeur de NavigoMédic, qui s’ouvre dans le navigateur du téléphone et s’installe sur l’écran d’accueil sans passer par un magasin d’applications. C’est la solution la plus simple, et celle que nous recommandons par défaut.
L’API intéresse un cas précis : le transporteur qui dispose déjà d’une application native pour ses chauffeurs, développée par lui ou par son prestataire, et qui souhaite y faire apparaître vos tournées. C’est souvent une société d’une certaine taille, qui travaille pour plusieurs établissements et veut garder un outil unique pour ses équipes. Notre page destinée aux taxis, ambulances et TPMR travaillant avec un établissement présente plus largement leur place dans NavigoMédic.
Ce que permet l’API transport adapté pour application mobile
Le périmètre est volontairement resserré sur le travail du chauffeur. L’API échange des données au format JSON, selon une logique de type REST familière à tout développeur mobile.
Se connecter
Le chauffeur s’identifie avec son compte NavigoMédic. L’API renvoie un jeton d’accès que l’application présentera à chaque appel.
Récupérer les tournées du jour
L’application obtient la ou les tournées du chauffeur, avec les arrêts dans l’ordre, les horaires et les informations utiles à la prise en charge.
Envoyer les pointages
À chaque arrêt, l’application transmet le statut, pris en charge, absent ou refus, avec l’horodatage du téléphone et sa position.
Traiter les erreurs
En cas de problème, l’API répond avec des erreurs normalisées, toujours structurées de la même manière.
Intégrer les tournées dans une application native
Les tournées transmises sont celles que l’établissement a construites et enregistrées. Si le secrétariat déclare une absence à 7 h 05, l’arrêt est retiré de la tournée et les horaires sont recalculés : l’application du transporteur obtient la tournée mise à jour à son prochain appel, là où notre propre application afficherait l’arrêt « ne pas se présenter ». Il appartient à l’application tierce de rafraîchir les données assez souvent pour que le chauffeur dispose de l’information à temps.
L’API de pointage chauffeur
Un pointage reçu par l’API a exactement la même valeur qu’un pointage fait dans notre application. Il est horodaté, localisé, comparé à l’adresse prévue, et il alimente l’audit des factures selon les mêmes règles. L’horodatage du téléphone est conservé : un chauffeur qui pointe dans un parking souterrain sans réseau peut envoyer son pointage plus tard, avec l’heure réelle de la prise en charge si elle est plausible. Ce principe est le même que celui du mode hors connexion de l’application chauffeur.
Un jeton d’accès révocable, haché et à durée limitée
Ouvrir une porte vers les données de vos tournées impose quelques précautions. L’API utilise un jeton porteur : une fois connecté, l’appareil présente ce jeton à chaque requête au lieu de renvoyer le mot de passe.
- Jeton haché. Le serveur ne conserve pas le jeton en clair, mais une empreinte. Une copie de la base de données ne suffirait pas à se faire passer pour un chauffeur.
- Jeton révocable. Un téléphone perdu, un chauffeur qui quitte la société : l’accès peut être coupé sans attendre.
- Expiration glissante. Le jeton reste valable tant qu’il sert régulièrement, et expire après une période d’inactivité.
- Même périmètre que le chauffeur. L’API ne donne accès qu’aux tournées du compte connecté, conformément aux rôles et droits d’accès du logiciel.
API REST transport : ce qu’elle n’est pas
L’API est conçue pour un usage : permettre à une application de chauffeur de suivre une tournée et de pointer. Ce n’est pas une porte d’entrée générale vers vos données. Elle ne sert pas à extraire la liste de vos usagers, à synchroniser un logiciel comptable ou à alimenter un dossier de l’usager ; NavigoMédic ne propose pas de connecteur de ce type. Elle n’envoie pas non plus d’alertes d’elle-même : c’est l’application du transporteur qui interroge le serveur.
Cette sobriété est un choix de sécurité autant que de simplicité. Moins une interface en fait, moins elle expose. Et pour l’établissement, rien ne change : le contrôle des factures, le pointage géolocalisé des prises en charge et les alertes du tableau de bord fonctionnent de la même façon, quelle que soit l’application utilisée par le chauffeur.
Mettre en place l’intégration avec votre transporteur
Le projet se mène à trois : l’établissement, le transporteur et son développeur. L’établissement crée les comptes des chauffeurs depuis la fiche de la société. Le développeur du transporteur branche son application sur l’API et la teste sur une tournée. Une fois les premiers pointages vérifiés côté établissement, l’application peut être utilisée sur l’ensemble des circuits. Pendant la transition, rien n’empêche les chauffeurs d’utiliser l’application NavigoMédic.
Si vous comparez plusieurs solutions, notre page consacrée à l’application de pointage pour chauffeur aide à poser les bonnes questions. Pour examiner le cas de votre transporteur, demandez un échange avec notre équipe, en associant si possible son responsable technique. L’ensemble des modules est présenté sur la page des fonctionnalités du logiciel.
Que permet l'API de pointage chauffeur ?
Elle permet à une application tierce de connecter un chauffeur, de récupérer ses tournées du jour et d’envoyer ses pointages, horodatés et localisés. Ces pointages ont la même valeur que ceux de l’application NavigoMédic pour l’audit des factures.
Comment intégrer les tournées dans une application native ?
Le développeur du transporteur appelle l’API avec le jeton du chauffeur connecté et affiche les arrêts reçus dans son application. Il doit rafraîchir les données régulièrement pour tenir compte des absences enregistrées dans la matinée.
Le jeton d'accès est-il révocable ?
Oui. Un jeton peut être révoqué à tout moment, par exemple après la perte d’un téléphone. Il est conservé haché côté serveur et expire après une période d’inactivité.
S'agit-il d'une API REST de transport complète ?
Non, son périmètre est limité au travail du chauffeur : connexion, tournées du jour, pointages. Elle n’est pas conçue pour exporter les données de l’établissement ni pour se connecter à un logiciel comptable ou à un dossier de l’usager.
Votre transporteur a sa propre application ?
Échangeons avec lui et son développeur sur le branchement de l'API, puis vérifions ensemble les premiers pointages. Ou commencez par l'audit gratuit d'un mois de factures.