La stessa analisi come container On-Prem nella Sua rete
L'API è lo stesso motore di analisi del programma desktop, confezionato come immagine di container che Lei gestisce On-Prem, ovvero su un server proprio o nel Suo cluster. I Suoi sistemi inviano i file delle carte al container via HTTP e ricevono l'analisi in JSON. Il container conserva i file delle carte solo nella memoria RAM. Non li salva sul disco e non li scrive in alcun file di log. Non invia a noi né i file delle carte né i risultati. Per consentirci di contare quanti conducenti analizza con la Sua licenza, il container si connette al nostro server delle licenze all'indirizzo license.scernetta.com, e precisamente dopo l'avvio, circa ogni 6 ore e quando si presenta un nuovo conducente. Il server delle licenze riceve in tal caso il testo del Suo file di licenza con il nome della Sua azienda, il numero di versione del container, alcuni valori tecnici di controllo e, per ogni nuovo conducente, un codice conducente. Il codice conducente viene calcolato dal container sul Suo server a partire dalla carta del conducente e dalla Sua chiave segreta.
A chi è destinata
È pensata per le flotte con un proprio TMS o ERP che vogliono elaborare l'analisi al loro interno. Gli operatori di telematica, che già raccolgono comunque i dati delle carte, possono farli verificare direttamente, e i fornitori di servizi che analizzano le carte del conducente per molti clienti si risparmiano il passaggio attraverso un programma desktop.
Come si svolge
Riceve da noi un file di licenza. Prima del primo avvio genera una sola volta, con un comando dell'immagine di container, una chiave segreta da cui il container calcola i codici conducente. Utilizzi questa chiave su tutte le installazioni e ne conservi una copia. Il container funziona su un server nella Sua rete e lì ha bisogno di una propria cartella, in cui registra quali conducenti hanno già uno slot conducente. Il server deve poter raggiungere license.scernetta.com, direttamente o tramite il Suo proxy HTTP. I Suoi sistemi si autenticano con una chiave API e trasmettono i file .ddd via HTTP, singolarmente o raggruppati per conducente, e il container li unisce esattamente come fa il programma desktop. Torna indietro un JSON con i turni, le infrazioni nella vista scelta, le previsioni e i periodi non valutabili, che Lei può elaborare direttamente.
Per un'intera flotta in una volta esiste un endpoint batch. Carica tutti i file in una sola richiesta, il container li attribuisce da sé ai conducenti e calcola in background. Per ogni nuovo conducente presente nella richiesta il container occupa uno slot conducente già al momento dell'invio. Se gli slot conducente liberi non bastano per tutti i nuovi conducenti, respinge l'intera richiesta e non occupa alcuno slot. Lo stato di avanzamento e i risultati per ogni conducente li interroga tramite un ID del job.
Stesso motore
Il programma desktop e l'API elaborano con lo stesso codice. Per lo stesso file e la stessa vista l'API fornisce gli stessi risultati del programma, come dati.
Due viste
Ogni risposta contiene uno dei due elenchi di infrazioni. L'impostazione predefinita è la vista rigorosa, che ricava ogni rilievo dal testo del regolamento e ne cita l'articolo. Secondo il diritto dell'UE può richiedere in alternativa la vista di riferimento, calibrata sul risultato di software affermati. Secondo le regole svizzere OLR 1 e OLR 2 esiste solo la vista rigorosa. Un endpoint dedicato fornisce il catalogo delle regole con i relativi riferimenti.
Rapporti
Il rapporto del programma desktop è disponibile anche tramite l'API, come HTML o come tabelle CSV in un file Zip. In più un manifest delle fonti che registra quale file caricato copre quale giorno.
Autenticità
Le firme e i certificati di una carta del conducente o di uno scarico di un'unità di bordo si possono verificare tramite l'API. La risposta indica che cosa è stato verificato. Le firme della prima generazione di carte questa versione non le verifica ancora, e ciò non è un indizio di manomissione.
Unità di bordo
Si può leggere anche il file scaricato dal veicolo. Vede quali carte sono state inserite in un determinato periodo e quali conducenti hanno guidato con esse.
Generazioni
Vengono lette carte del conducente della generazione 1 e della generazione 2, compresa la versione 2. I file delle unità di bordo l'API li legge solo nei formati della generazione 2.
OpenAPI
L'interfaccia è descritta come specifica OpenAPI 3.1 che il container stesso fornisce. La documentazione su docs.scernetta.com viene generata da essa.
Come vengono contati i conducenti
Ogni carta del conducente che analizza durante il periodo di validità della Sua licenza conta una volta come conducente, indipendentemente da quante volte la analizzi. Se un conducente riceve una carta rinnovata o una carta sostitutiva, resta lo stesso conducente. Se riceve una carta di un altro Paese, conta come nuovo conducente. Un conducente mantiene il suo slot conducente fino alla fine del periodo di validità, anche se lascia prima la Sua azienda. Il conteggio riguarda tutte le Sue installazioni insieme, compresa un'installazione di prova. Non occupano alcuno slot conducente la carta di esempio del nostro sito web, la verifica dell'autenticità e i file delle unità di bordo.
Licenza
L'API viene concessa in licenza in base al numero di conducenti e fatturata annualmente. Il container verifica da sé l'autenticità del file di licenza tramite la sua firma digitale e per questo non ha bisogno di alcuna connessione con noi. Quando un conducente viene analizzato per la prima volta nel periodo di validità, il container richiede per lui uno slot conducente al nostro server delle licenze. Se una licenza a pagamento scade, il container continua a calcolare ancora per 14 giorni, così l'analisi non si ferma se il rinnovo arriva qualche giorno più tardi. Il prezzo lo comunichiamo su richiesta, perché dipende dalle dimensioni della flotta.
Senza connessione al server delle licenze
Il container continua ad analizzare i conducenti che hanno già uno slot conducente anche senza connessione al nostro server delle licenze, per 30 giorni dall'ultima connessione oppure per 14 giorni con una licenza di prova. Per i nuovi conducenti una licenza a pagamento dispone di una riserva, nel caso in cui il nostro server delle licenze non sia raggiungibile per più di un minuto. La riserva corrisponde a un decimo degli slot conducente, ma almeno a 2 slot per periodo di validità, quindi a 3 con 30 slot. Per questo il container ha bisogno della sua cartella sul server. Segnala in seguito questi conducenti, non appena il server delle licenze è di nuovo raggiungibile. Una licenza di prova non dispone di alcuna riserva.
Che cosa lascia il server
I file delle carte vengono elaborati On-Prem, ovvero nella Sua rete, e non vengono mai trasmessi a noi. Il codice conducente viene calcolato dal container sul Suo server a partire dalla carta del conducente e dalla Sua chiave segreta, che non riceviamo mai. Dal codice non possiamo risalire a chi sia il conducente. Con la Sua chiave, tuttavia, il codice può essere ricondotto a un conducente, per questo ai sensi del RGPD rientra tra i dati personali. Può richiamare e leggere presso il container gli ultimi 20 messaggi che questo ha inviato al nostro server delle licenze dal suo avvio, così come apparivano prima della cifratura.
La documentazione dell'interfaccia si trova su docs.scernetta.com e viene generata dal file OpenAPI. Inizia con una guida all'avvio, alla licenza e alla gestione degli errori e descrive ogni endpoint con i suoi parametri.Vai alla documentazione
Se vuole utilizzare l'API, ci scriva quali sistemi desidera collegare e di quanti conducenti o veicoli si tratta. Le risponderemo poi con un accesso.