Déiselwecht Auswäertung als On-Prem-Container an Ärem Netzwierk
D'API ass dee selwechten Auswäertungskär wéi am Desktop-Programm, verpaakt als Container-Image, dat Dir On-Prem bedreift, also op engem eegene Server oder an Ärem Cluster. Är Systemer schécken d'Kaartedateie per HTTP un de Container a kréien d'Auswäertung als JSON zréck. De Container hält d'Kaartedateien nëmmen am Aarbechtsspäicher. En späichert se net op der Festplack a schreift se a keng Logdatei. Kaartedateien a Resultater schéckt en net un eis. Fir datt mir ziele kënnen, wéi vill Chauffeuren Dir mat Ärer Lizenz auswäert, verbënnt en sech mat eisem Lizenzserver ënner license.scernetta.com, an zwar nom Start, ongeféier all 6 Stonnen a bei engem neie Chauffeur. De Lizenzserver kritt dobäi den Text vun Ärer Lizenzdatei mat Ärem Firmennumm, d'Versiounsnummer vum Container, e puer technesch Préifwäerter a fir all neie Chauffeur e Chauffeurscode. De Chauffeurscode berechent de Container op Ärem Server aus der Chauffeurskaart an Ärem geheime Schlëssel.
Fir wien dat geduecht ass
Geduecht ass dat fir Flotte mat eegenem TMS oder ERP, déi d'Auswäertung do weiderveraarbechte wëllen. Telematik-Ubidder, déi Kaartendaten esou wéi esou scho sammelen, kënne se domat direkt loosse préiwen, an Déngschtleeschter, déi Chauffeurskaarte fir vill Cliente auswäerten, spueren sech den Ëmwee iwwer e Desktop-Programm.
Wéi dat ofleeft
Dir kritt vun eis eng Lizenzdatei. Virum éischte Start erstellt Dir eemol mat engem Befeel aus dem Container-Image e geheime Schlëssel, aus deem de Container d'Chauffeurscoden berechent. Benotzt dëse Schlëssel op allen Installatiounen a bewaart eng Kopie op. De Container leeft op engem Server an Ärem Netzwierk a brauch do en eegenen Dossier, an deem e festhält, wéi eng Chauffeure schonn eng Chauffeursplaz hunn. De Server muss license.scernetta.com erreeche kënnen, direkt oder iwwer Ären HTTP-Proxy. Är Systemer melle sech mat engem API-Schlëssel un an iwwerginn d'.ddd-Dateie per HTTP, eenzel oder gebündelt pro Chauffeur, an de Container féiert se genau esou zesummen, wéi et d'Desktop-Programm mécht. Zréck kënnt e JSON mat de Schichten, de Verstéiss an der gewielter Siicht, de Prognosen an den net bewäertbaren Zäiträim, dat Dir direkt weiderveraarbechte kënnt.
Fir eng ganz Flott op eemol gëtt et e Batch-Endpunkt. Dir lued all d'Dateien an enger Ufro erop, de Container ordent se selwer de Chauffeuren zou a rechent am Hannergrond. Fir all neie Chauffeur an der Ufro beleet de Container scho beim Areeche vun der Ufro eng Chauffeursplaz. Ginn déi fräi Chauffeursplazen net fir all nei Chauffeuren duer, refuséiert en déi ganz Ufro a beleet keng Plaz. De Fortschrëtt an d'Resultater pro Chauffeur freet Dir iwwer eng Job-ID of.
Selwechte Kär
Desktop-Programm an API rechne mat deem selwechte Code. Fir déiselwecht Datei an déiselwecht Siicht liwwert d'API déiselwecht Resultater wéi d'Programm, als Daten.
Zwou Siichten
All Äntwert enthält eng vun den zwou Verstoosslëschten. Virastellt ass déi streng Siicht, déi all Befund aus dem Veruerdnungstext ofleet an den Artikel dozou nennt. No EU-Recht kënnt Dir amplaz d'Referenz-Siicht ufroen, déi um Resultat vun etabléierter Software kalibréiert ass. No de Schwäizer Reegelen ARV 1 an ARV 2 gëtt et nëmmen déi streng Siicht. En eegenen Endpunkt liwwert de Katalog vun de Reegele mat hire Fundplazen.
Rapporten
De Rapport aus dem Desktop-Programm kënnt och iwwer d'API, als HTML oder als CSV-Tabellen am Zip. Dozou e Quellemanifest, dat festhält, wéi eng eropgelueden Datei wéi ee Dag beleet.
Echtheet
Signaturen an Zertifikater vun enger Chauffeurskaart oder engem Gefierseenheeten-Download loosse sech iwwer d'API préiwen. D'Äntwert seet, wat verifizéiert gouf. Signaturen vun der éischter Kaartegeneratioun préift dës Versioun nach net, dat ass kee Hiweis op eng Manipulatioun.
Gefierseenheet
Och d'Download-Datei vum Gefier léisst sech aliesen. Dir gesitt, wéi eng Kaarten an engem Zäitraum gestach hunn a wéi eng Chauffeuren domat gefuer sinn.
Generatiounen
Geliest ginn Chauffeurskaarten vun der Generatioun 1 souwéi vun der Generatioun 2 abegraff Versioun 2. Dateie vu Gefierseenheeten liest d'API nëmmen an de Formater vun der Generatioun 2.
OpenAPI
D'Schnëttplaz ass als OpenAPI-3.1-Spezifikatioun beschriwwen, déi de Container selwer ausliwwert. D'Dokumentatioun ënner docs.scernetta.com gëtt doraus erstallt.
Wéi Chauffeure gezielt ginn
All Chauffeurskaart, déi Dir während der Laafzäit vun Ärer Lizenz auswäert, zielt eemol als Chauffeur, egal wéi dacks Dir se auswäert. Kritt e Chauffeur eng erneiert Kaart oder eng Ersatzkaart, bleift en dee selwechte Chauffeur. Kritt en eng Kaart aus engem anere Land, zielt en als neie Chauffeur. Seng Chauffeursplaz behält e Chauffeur bis zum Enn vun der Laafzäit, och wann en Är Entreprise virdru verléisst. Gezielt gëtt iwwer all Är Installatiounen zesummen, och eng Testinstallatioun. Keng Chauffeursplaz beleeën d'Beispillkaart vun eiser Websäit, d'Echtheetspréiwung an Dateie vu Gefierseenheeten.
Lizenz
D'API gëtt no der Zuel vun de Chauffeuren lizenzéiert a jäerlech ofgerechent. Ob d'Lizenzdatei echt ass, préift de Container selwer un hirer digitaler Signatur, dofir brauch en keng Verbindung zu eis. Gëtt e Chauffeur an der Laafzäit fir d'éischt ausgewäert, freet de Container bei eisem Lizenzserver eng Chauffeursplaz fir hien un. Leeft eng bezuelt Lizenz of, rechent de Container nach 14 Deeg weider, fir datt d'Auswäertung net stoe bleift, wann d'Verlängerung e puer Deeg méi spéit kënnt. De Präis nenne mir op Ufro, well en vun der Gréisst vun der Flott ofhänkt.
Ouni Verbindung zum Lizenzserver
Chauffeuren, déi schonn eng Chauffeursplaz hunn, wäert de Container och ouni Verbindung zu eisem Lizenzserver weider aus, 30 Deeg laang vun der leschter Verbindung un, mat enger Testlizenz 14 Deeg. Fir nei Chauffeuren huet eng bezuelt Lizenz eng Reserve, fir de Fall, datt eise Lizenzserver méi laang wéi eng Minutt net ze erreechen ass. D'Reserve ass en Zéngtel vun de Chauffeursplazen, op d'mannst awer 2 Plaze pro Laafzäit, bei 30 Plazen also 3. Dofir brauch de Container säin Dossier um Server. Dës Chauffeure mellt en no, soubal de Lizenzserver erëm ze erreechen ass. Eng Testlizenz huet keng Reserve.
Wat de Server verléisst
D'Kaartedateie ginn On-Prem veraarbecht, also an Ärem Netzwierk, an ni un eis iwwerdroen. De Chauffeurscode berechent de Container op Ärem Server aus der Chauffeurskaart an Ärem geheime Schlëssel, dee mir ni kréien. Mir kënnen aus dem Code net erausliesen, wien de Chauffeur ass. Mat Ärem Schlëssel léisst de Code sech awer erëm engem Chauffeur zouuerdnen, dofir gehéiert en no der DSGVO zu de personebezunnen Daten. Déi lescht 20 Noriichten, déi de Container zënter sengem Start un eise Lizenzserver geschéckt huet, kënnt Dir beim Container ofruffen a liesen, sou wéi se virun der Verschlësselung ausgesinn hunn.
D'Dokumentatioun vun der Schnëttplaz läit ënner docs.scernetta.com a gëtt aus der OpenAPI-Datei erstallt. Si fänkt mat engem Leitfuedem zu Start, Lizenz a Feelerbehandlung un a beschreift all Endpunkt mat senge Parameteren.Bei d'Dokumentatioun
Wann Dir d'API asetze wëllt, schreift eis, wéi eng Systemer Dir ubanne wëllt an ëm wéi vill Chauffeuren oder Gefierer et geet. Mir mellen eis da mat engem Zougang.