Die gliich Uswertig als On-Prem-Container in Ihrem Netzwärk
D API isch de gliich Uswertigskern wie im Desktop-Program, verpackt als Container-Image, wo Sie On-Prem betriibed, also uf eme eigene Server oder in Ihrem Cluster. Ihri Syschtem schicked d Chartedateie per HTTP a de Container und überchömed d Uswertig als JSON zrugg. De Container haltet d Chartedateie nu im Arbetsspeicher. Er speicheret si nöd uf de Festplatte und schriibt si in kei Logdatei. Chartedateie und Ergäbnis schickt er nöd a üs. Damit mir zelle chönd, wie vill Fahrer Sie mit Ihrer Lizänz uswerted, verbindet er sich mit üsem Lizänzserver under license.scernetta.com, und zwar nach em Start, öppe alli 6 Stund und bi eme neue Fahrer. De Lizänzserver überchunnt debi de Text vo Ihrer Lizänzdatei mit Ihrem Firmename, d Versionsnummere vom Container, es paar technischi Prüefwärt und für jede neue Fahrer en Fahrercode. De Fahrercode berechnet de Container uf Ihrem Server us de Fahrerkarte und Ihrem gheime Schlüssel.
Für wän das dänkt isch
Dänkt isch das für Flotte mit eigem TMS oder ERP, wo d Uswertig det witerverarbeite wänd. Telematikaabieter, wo d Chartedate eh scho iisammled, chönd si damit direkt prüefe la, und Dienschtleischter, wo Fahrerkarte für vill Chunde uswertet, spared sich de Umwäg über es Desktop-Program.
Wie das ablauft
Sie überchömed vo üs e Lizänzdatei. Vor em erschte Start erzüged Sie einisch mit eme Befehl us em Container-Image en gheime Schlüssel, us dem de Container d Fahrercodes berechnet. Verwended Sie dä Schlüssel uf allne Installatione und bewahred Sie e Kopie uf. De Container lauft uf eme Server in Ihrem Netzwärk und bruucht det en eigene Ordner, i dem er festhaltet, weli Fahrer scho en Fahrerplatz händ. De Server mues license.scernetta.com chöne erreiche, direkt oder über Ihre HTTP-Proxy. Ihri Syschtem mälded sich mit eme API-Schlüssel aa und übergäbed d .ddd-Dateie per HTTP, einzeln oder gebündlet pro Fahrer, und de Container führt si genau so zäme, wie s das Desktop-Program macht. Zrugg chunnt es JSON mit de Schichte, de Verstöss in de gwählte Sicht, de Prognose und de nöd bewertbare Ziiträum, wo Sie direkt witerverarbeite chönd.
Für e ganzi Flotte uf einisch git s en Batch-Endpunkt. Sie laded alli Dateie in ere Afroog ufe, de Container ordnet si selber de Fahrer zue und rechnet im Hintergrund. Für jede neue Fahrer in de Afroog belegt de Container scho bim Iireiche en Fahrerplatz. Länged di freie Fahrerplätz nöd für alli neue Fahrer, lehnt er di ganz Afroog ab und belegt kei Platz. De Fortschritt und d Ergäbnis pro Fahrer froged Sie über e Job-ID ab.
Gliiche Kern
Desktop-Program und API rechned mit em gliiche Code. Für di gliich Datei und di gliich Sicht lieferet d API di gliiche Ergäbnis wie s Program, als Date.
Zwöi Sichte
Jedi Antwort enthaltet eini vo de beide Verstosslischte. Voriigstellt isch di strängi Sicht, wo jede Befund us em Verordnigstext ableitet und de Artikel dezue nännt. Nach EU-Rächt chönd Sie stattdesse d Referänz-Sicht abfroge, wo am Ergäbnis vo etablierter Software kalibriert isch. Nach de Schwiizer Regle ARV 1 und ARV 2 git s nu di strängi Sicht. En eigene Endpunkt lieferet de Katalog vo de Regle mit ihrne Fundstelle.
Bericht
De Bericht us em Desktop-Program chunnt au über d API, als HTML oder als CSV-Tabelle im Zip. Dezue es Quellemanifescht, wo festhaltet, weli ufeglade Datei wele Tag belegt.
Echtheit
Signature und Zertifikat vo ere Fahrerkarte oder eme Fahrzeugeinheite-Download lönd sich über d API prüefe. D Antwort seit, was verifiziert worde isch. Signature vo de erschte Chartegeneration prüeft die Version no nöd, das isch kei Hiiwiis uf e Manipulation.
Fahrzeugeinheit
Au d Download-Datei vom Fahrzüg lat sich iiläse. Sie gsehnd, weli Charte in eme Ziitruum gsteckt händ und weli Fahrer damit gfahre sind.
Generatione
Gläse werdet Fahrerkarte vo de Generation 1 sowie de Generation 2 iischliesslich Version 2. Dateie vo Fahrzeugeinheite liest d API nu i de Format vo de Generation 2.
OpenAPI
D Schnittstell isch als OpenAPI-3.1-Spezifikation beschriebe, wo de Container selber usliferet. D Dokumentation under docs.scernetta.com wird drus erzügt.
Wie Fahrer zellt werdet
Jedi Fahrerkarte, wo Sie während de Laufzit vo Ihrer Lizänz uswerted, zellt einisch als Fahrer, egal wie oft Sie si uswerted. Überchunnt en Fahrer e erneuereti Charte oder e Ersatzkarte, bliibt er de gliich Fahrer. Überchunnt er e Charte us eme andere Land, zellt er als neue Fahrer. Sin Fahrerplatz behaltet en Fahrer bis zum Änd vo de Laufzit, au wänn er Ihres Unternäme vorher verlaht. Zellt wird über alli Ihri Installatione zäme, au e Teschtinstallation. Kei Fahrerplatz beleged d Bispilcharte vo üsere Website, d Echtheitsprüefig und Dateie us Fahrzeugeinheite.
Lizänz
D API wird nach de Aazahl Fahrer lizenziert und jährlich abgrächnet. Öb d Lizänzdatei echt isch, prüeft de Container selber a ihrer digitale Signatur, defür bruucht er kei Verbindig zu üs. Wird en Fahrer i de Laufzit zum erschte Mal usgwertet, frögt de Container bi üsem Lizänzserver en Fahrerplatz für ihn aa. Lauft e bezahlti Lizänz ab, rechnet de Container no 14 Täg witer, damit d Uswertig nöd stah bliibt, wänn d Verlängerig es paar Täg spöter chunnt. De Priis nänned mir uf Afroog, wil er vo de Grössi vo de Flotte abhängt.
Ohni Verbindig zum Lizänzserver
Fahrer, wo scho en Fahrerplatz händ, wertet de Container au ohni Verbindig zu üsem Lizänzserver witer us, 30 Täg lang ab de letschte Verbindig, mit ere Teschtlizänz 14 Täg. Für neui Fahrer het e bezahlti Lizänz e Reserve, falls üse Lizänzserver länger als e Minute nöd erreichbar isch. D Reserve isch es Zehntel vo de Fahrerplätz, mindeschtens aber 2 Plätz pro Laufzit, bi 30 Plätz also 3. Defür bruucht de Container sin Ordner uf em Server. Die Fahrer mäldet er nache, sobald de Lizänzserver wieder erreichbar isch. E Teschtlizänz het kei Reserve.
Was de Server verlaht
D Chartedateie werdet On-Prem verarbeitet, also in Ihrem Netzwärk, und nie a üs übertrage. De Fahrercode berechnet de Container uf Ihrem Server us de Fahrerkarte und Ihrem gheime Schlüssel, wo mir nie überchömed. Mir chönd us em Code nöd abläse, wer de Fahrer isch. Mit Ihrem Schlüssel lat sich de Code aber wieder eme Fahrer zueordne, drum ghört er nach de DSGVO zu de persoonebezogene Date. Di letschte 20 Nachrichte, wo de Container sit sim Start a üse Lizänzserver gschickt het, chönd Sie bim Container abrüefe und läse, so wie si vor de Verschlüsselig usgseh händ.
D Dokumentation vo de Schnittstell liit under docs.scernetta.com und wird us de OpenAPI-Datei erzügt. Si fangt mit eme Leitfade zu Start, Lizänz und Fehlerbehandlig aa und beschriibt jede Endpunkt mit sine Parameter.Zur Dokumentation
Wänn Sie d API iisetze wänd, schriibed Sie üs, weli Syschtem Sie aabinde wänd und um wie vill Fahrer oder Fahrzüg s gaht. Mir mälded üs denn mit eme Zuegang.