La mateixa anàlisi com a Container On-Prem a la seva xarxa
L'API és el mateix nucli d'anàlisi que el programa d'escriptori, empaquetat com a imatge de Container que vostè executa On-Prem, és a dir, en un servidor propi o en el seu clúster. Els seus sistemes envien els fitxers de targeta al Container per HTTP i reben l'anàlisi com a JSON. El Container conserva els fitxers de targeta només a la memòria principal. No els desa al disc i no els escriu en cap fitxer de registre. No ens envia ni els fitxers de targeta ni els resultats. Perquè puguem comptar quants conductors analitza amb la seva llicència, es connecta amb el nostre servidor de llicències a license.scernetta.com, concretament després d'iniciar-se, aproximadament cada 6 hores i quan apareix un conductor nou. En fer-ho, el servidor de llicències rep el text del seu fitxer de llicència amb el nom de la seva empresa, el número de versió del Container, alguns valors de control tècnics i, per a cada conductor nou, un codi de conductor. El codi de conductor el calcula el Container al seu servidor a partir de la targeta de conductor i de la seva clau secreta.
Per a qui està pensat
Està pensat per a flotes amb un TMS o un ERP propi que vulguin continuar processant-hi l'anàlisi. Els proveïdors de telemàtica que ja recullen dades de targetes de totes maneres poden fer-les comprovar directament, i els proveïdors de serveis que analitzen targetes de conductor per a molts clients s'estalvien la marrada d'un programa d'escriptori.
Com funciona
Rep de nosaltres un fitxer de llicència. Abans del primer inici, genera una sola vegada una clau secreta amb una ordre de la imatge de Container. A partir d'aquesta clau, el Container calcula els codis de conductor. Utilitzi aquesta clau a totes les instal·lacions i guardi'n una còpia. El Container s'executa en un servidor de la seva xarxa i hi necessita una carpeta pròpia, on registra quins conductors ja tenen una plaça de conductor. El servidor ha de poder accedir a license.scernetta.com, directament o a través del seu proxy HTTP. Els seus sistemes s'identifiquen amb una clau d'API i lliuren els fitxers .ddd per HTTP, d'un en un o agrupats per conductor, i el Container els uneix exactament com ho fa el programa d'escriptori. De tornada arriba un JSON amb els torns, les infraccions de la vista escollida, les previsions i els períodes no avaluables, que pot continuar processant directament.
Per a tota una flota alhora hi ha un endpoint de lots. Puja tots els fitxers en una sola sol·licitud, el Container els assigna ell mateix als conductors i els processa en segon pla. Per a cada conductor nou de la sol·licitud, el Container ocupa una plaça de conductor ja en el moment d'enviar-la. Si no hi ha prou places de conductor lliures per a tots els conductors nous, rebutja tota la sol·licitud i no ocupa cap plaça. El progrés i els resultats per conductor es consulten mitjançant un identificador de tasca (job id).
El mateix nucli
El programa d'escriptori i l'API calculen amb el mateix codi. Per al mateix fitxer i la mateixa vista, l'API lliura els mateixos resultats que el programa, com a dades.
Dues vistes
Cada resposta conté una de les dues llistes d'infraccions. Per defecte s'aplica la vista estricta, que deriva cada troballa del text del reglament i n'esmenta l'article. Segons el dret de la UE, pot sol·licitar en lloc seu la vista de referència, que està calibrada contra el resultat del programari establert. Segons les normes suïsses ARV 1 i ARV 2 només hi ha la vista estricta. Un endpoint propi lliura el catàleg de les regles amb les seves referències.
Informes
L'informe del programa d'escriptori també està disponible mitjançant l'API, com a HTML o com a taules CSV dins d'un Zip. Amb ell ve un manifest de fonts que indica quin fitxer pujat justifica quin dia.
Autenticitat
Les signatures i els certificats d'una targeta de conductor o d'una baixada d'unitat de vehicle es poden comprovar mitjançant l'API. La resposta diu què s'ha verificat. Aquesta versió encara no comprova les signatures de la primera generació de targetes, i això no és cap indici de manipulació.
Unitat de vehicle
També es pot llegir el fitxer de baixada del vehicle. Veu quines targetes van estar inserides en un període i quins conductors hi van conduir.
Generacions
Es llegeixen targetes de conductor de la generació 1 i de la generació 2, inclosa la versió 2. Els fitxers d'unitats de vehicle, l'API només els llegeix en els formats de la generació 2.
OpenAPI
La interfície es descriu com una especificació OpenAPI 3.1 que el Container serveix ell mateix. La documentació a docs.scernetta.com es genera a partir d'ella.
Com es compten els conductors
Cada targeta de conductor que analitzi durant el període de vigència de la seva llicència compta una vegada com a conductor, independentment de quantes vegades l'analitzi. Si un conductor rep una targeta renovada o una targeta de substitució, continua sent el mateix conductor. Si rep una targeta d'un altre país, compta com a conductor nou. Un conductor conserva la seva plaça de conductor fins al final del període de vigència, encara que abans deixi l'empresa. Es compta sobre el conjunt de totes les seves instal·lacions, incloent-hi una instal·lació de prova. No ocupen cap plaça de conductor la targeta d'exemple del nostre lloc web, la comprovació d'autenticitat ni els fitxers d'unitats de vehicle.
Llicència
L'API es llicencia segons el nombre de conductors i es factura anualment. El Container mateix comprova si el fitxer de llicència és autèntic a partir de la seva signatura digital, i per a això no necessita cap connexió amb nosaltres. Quan un conductor s'analitza per primera vegada dins del període de vigència, el Container sol·licita al nostre servidor de llicències una plaça de conductor per a ell. Quan caduca una llicència de pagament, el Container continua calculant 14 dies més, perquè l'anàlisi no s'aturi si la renovació arriba amb uns quants dies de retard. El preu l'indiquem sota petició, perquè depèn de la mida de la flota.
Sense connexió amb el servidor de llicències
El Container continua analitzant els conductors que ja tenen una plaça de conductor també sense connexió amb el nostre servidor de llicències, durant 30 dies des de l'última connexió, o 14 dies amb una llicència de prova. Per als conductors nous, una llicència de pagament té una reserva per si el nostre servidor de llicències no és accessible durant més d'un minut. La reserva és la desena part de les places de conductor, però com a mínim 2 places per període de vigència, és a dir, 3 amb 30 places. Per a això el Container necessita la seva carpeta al servidor. Aquests conductors els notifica posteriorment tan bon punt el servidor de llicències torna a ser accessible. Una llicència de prova no té reserva.
Què surt del servidor
Els fitxers de targeta es processen On-Prem, és a dir, dins de la seva xarxa, i no se'ns transfereixen mai. El codi de conductor el calcula el Container al seu servidor a partir de la targeta de conductor i de la seva clau secreta, que nosaltres no rebem mai. A partir del codi no podem saber qui és el conductor. Amb la seva clau, però, el codi es pot tornar a associar a un conductor, i per això, segons el RGPD, forma part de les dades personals. Els últims 20 missatges que el Container ha enviat al nostre servidor de llicències des que es va iniciar els pot consultar i llegir al Container, tal com eren abans de xifrar-los.
La documentació de la interfície es troba a docs.scernetta.com i es genera a partir del fitxer OpenAPI. Comença amb una guia sobre l'inici, la llicència i la gestió d'errors, i descriu cada endpoint amb els seus paràmetres.Anar a la documentació
Si vol utilitzar l'API, digui'ns quins sistemes vol connectar i de quants conductors o vehicles es tracta. Ens posarem en contacte amb vostè amb un accés.