La même analyse en Container On-Prem dans votre réseau
L'API est le même moteur d'analyse que dans le programme de bureau, empaqueté sous forme d'image de Container que vous exploitez On-Prem, c'est-à-dire sur un serveur qui vous appartient ou dans votre cluster. Vos systèmes envoient les fichiers de carte au Container par HTTP et récupèrent l'analyse au format JSON. Le Container conserve les fichiers de carte uniquement en mémoire vive. Il ne les enregistre pas sur le disque et ne les écrit dans aucun fichier journal. Il ne nous envoie ni les fichiers de carte ni les résultats. Pour que nous puissions compter combien de conducteurs vous analysez avec votre licence, il se connecte à notre serveur de licences à l'adresse license.scernetta.com, après son démarrage, environ toutes les 6 heures et lorsqu'un nouveau conducteur apparaît. Le serveur de licences reçoit alors le texte de votre fichier de licence avec le nom de votre entreprise, le numéro de version du Container, quelques valeurs de contrôle techniques et, pour chaque nouveau conducteur, un code conducteur. Le Container calcule le code conducteur sur votre serveur à partir de la carte de conducteur et de votre clé secrète.
À qui cela s'adresse
Cela s'adresse aux flottes disposant de leur propre TMS ou ERP qui veulent y poursuivre le traitement de l'analyse. Les fournisseurs de télématique qui collectent de toute façon déjà les données de carte peuvent les faire vérifier directement, et les prestataires qui analysent des cartes de conducteur pour de nombreux clients s'épargnent le détour par un programme de bureau.
Comment cela se déroule
Vous recevez de nous un fichier de licence. Avant le premier démarrage, vous générez une fois, avec une commande de l'image de Container, une clé secrète à partir de laquelle le Container calcule les codes conducteur. Utilisez cette clé sur toutes les installations et conservez-en une copie. Le Container s'exécute sur un serveur de votre réseau et y a besoin d'un dossier qui lui est propre, dans lequel il note les conducteurs qui ont déjà une place de conducteur. Le serveur doit pouvoir joindre license.scernetta.com, directement ou via votre proxy HTTP. Vos systèmes s'authentifient avec une clé API et transmettent les fichiers .ddd par HTTP, un par un ou regroupés par conducteur, et le Container les fusionne exactement comme le fait le programme de bureau. En retour, vous recevez un JSON contenant les vacations, les infractions dans la vue choisie, les prévisions et les périodes non évaluables, que vous pouvez traiter directement.
Pour toute une flotte en une fois, il existe un point de terminaison par lots. Vous téléversez tous les fichiers en une seule requête, le Container les attribue lui-même aux conducteurs et les traite en arrière-plan. Pour chaque nouveau conducteur de la requête, le Container occupe une place de conducteur dès la soumission. Si les places de conducteur libres ne suffisent pas pour tous les nouveaux conducteurs, il refuse la requête entière et n'occupe aucune place. L'avancement et les résultats par conducteur se consultent au moyen d'un identifiant de tâche.
Même moteur
Le programme de bureau et l'API calculent avec le même code. Pour le même fichier et la même vue, l'API livre les mêmes résultats que le programme, sous forme de données.
Deux vues
Chaque réponse contient l'une des deux listes d'infractions. Par défaut, c'est la vue stricte, qui dérive chaque constat du texte du règlement et en cite l'article. Selon le droit de l'UE, vous pouvez demander à la place la vue de référence, qui est calibrée sur le résultat des logiciels établis. Selon les règles suisses OTR 1 et OTR 2, seule la vue stricte est disponible. Un point de terminaison dédié fournit le catalogue des règles avec leurs références.
Rapports
Le rapport du programme de bureau est aussi disponible via l'API, en HTML ou sous forme de tableaux CSV dans un zip. S'y ajoute un manifeste des sources, qui consigne quel fichier téléversé documente quel jour.
Authenticité
Les signatures et les certificats d'une carte de conducteur ou d'un téléchargement d'unité embarquée peuvent être vérifiés via l'API. La réponse indique ce qui a été vérifié. Cette version ne vérifie pas encore les signatures de la première génération de carte, ce qui n'est pas un indice de manipulation.
Unité embarquée
Le fichier de téléchargement du véhicule peut lui aussi être lu. Vous voyez quelles cartes ont été insérées au cours d'une période et quels conducteurs ont conduit avec elles.
Générations
Sont lues les cartes de conducteur de la génération 1 ainsi que de la génération 2, y compris la version 2. L'API ne lit les fichiers d'unités embarquées que dans les formats de la génération 2.
OpenAPI
L'interface est décrite sous forme de spécification OpenAPI 3.1 que le Container fournit lui-même. La documentation sur docs.scernetta.com est générée à partir de celle-ci.
Comment les conducteurs sont comptés
Chaque carte de conducteur que vous analysez pendant la durée de votre licence compte une fois comme conducteur, quel que soit le nombre de fois où vous l'analysez. Un conducteur qui reçoit une carte renouvelée ou une carte de remplacement reste le même conducteur. Un conducteur qui reçoit une carte délivrée dans un autre pays compte comme un nouveau conducteur. Un conducteur conserve sa place de conducteur jusqu'à la fin de la durée de la licence, même s'il quitte votre entreprise avant. Le décompte porte sur toutes vos installations ensemble, y compris une installation de test. La carte d'exemple de notre site, la vérification d'authenticité et les fichiers d'unités embarquées n'occupent aucune place de conducteur.
Licence
L'API est concédée sous licence selon le nombre de conducteurs et facturée annuellement. Le Container vérifie lui-même l'authenticité du fichier de licence au moyen de sa signature numérique. Il n'a pas besoin pour cela d'une connexion avec nous. Lorsqu'un conducteur est analysé pour la première fois pendant la durée de la licence, le Container demande une place de conducteur pour ce conducteur à notre serveur de licences. À l'expiration d'une licence payante, le Container continue de calculer pendant 14 jours, afin que l'analyse ne s'arrête pas si le renouvellement arrive quelques jours plus tard. Nous communiquons le prix sur demande, car il dépend de la taille de la flotte.
Sans connexion au serveur de licences
Le Container continue d'analyser les conducteurs qui ont déjà une place de conducteur même sans connexion à notre serveur de licences, pendant 30 jours à compter de la dernière connexion, 14 jours avec une licence d'essai. Pour les nouveaux conducteurs, une licence payante dispose d'une réserve au cas où notre serveur de licences serait injoignable pendant plus d'une minute. La réserve représente un dixième des places de conducteur, mais au moins 2 places sur la durée de la licence, soit 3 pour 30 places. Pour cela, le Container a besoin de son dossier sur le serveur. Il déclare ces conducteurs a posteriori dès que le serveur de licences est de nouveau joignable. Une licence d'essai n'a pas de réserve.
Ce qui quitte le serveur
Les fichiers de carte sont traités On-Prem, c'est-à-dire dans votre réseau, et ne nous sont jamais transmis. Le Container calcule le code conducteur sur votre serveur à partir de la carte de conducteur et de votre clé secrète, que nous ne recevons jamais. Nous ne pouvons pas déduire du code qui est le conducteur. Avec votre clé, le code peut toutefois être rattaché à un conducteur, c'est pourquoi il constitue une donnée à caractère personnel au sens du RGPD. Vous pouvez consulter auprès du Container les 20 derniers messages qu'il a envoyés à notre serveur de licences depuis son démarrage, et les lire tels qu'ils étaient avant le chiffrement.
La documentation de l'interface se trouve sur docs.scernetta.com et est générée à partir du fichier OpenAPI. Elle commence par un guide de démarrage, de licence et de gestion des erreurs et décrit chaque point de terminaison avec ses paramètres.Accéder à la documentation
Si vous souhaitez utiliser l'API, indiquez-nous quels systèmes vous voulez connecter et combien de conducteurs ou de véhicules sont concernés. Nous vous recontacterons alors avec un accès.