Dieselbe Auswertung als On-Prem-Container in Ihrem Netzwerk
Die API ist derselbe Auswertungskern wie im Desktop-Programm, verpackt als Container-Image, das Sie On-Prem betreiben, also auf einem eigenen Server oder in Ihrem Cluster. Ihre Systeme schicken die Kartendateien per HTTP an den Container und bekommen die Auswertung als JSON zurück. Die Kartendaten werden im Arbeitsspeicher verarbeitet, nie auf Platte geschrieben und nie protokolliert. Der Container baut keine Verbindung nach außen auf, an uns wird nichts davon übertragen.
Für wen das gedacht ist
Gedacht ist das für Flotten mit eigenem TMS oder ERP, die die Auswertung dort weiterverarbeiten wollen. Telematikanbieter, die Kartendaten ohnehin schon einsammeln, können sie damit direkt prüfen lassen, und Dienstleister, die Fahrerkarten für viele Kunden auswerten, sparen sich den Umweg über ein Desktop-Programm.
Wie das abläuft
Sie bekommen von uns einen Aktivierungscode, tauschen ihn einmalig gegen ein Lizenz-Token und starten den Container damit auf einem Server in Ihrem Netzwerk. Dann übergeben Ihre Systeme die .ddd-Dateien per HTTP, einzeln oder gebündelt pro Fahrer, und der Container führt sie genauso zusammen, wie es das Desktop-Programm tut. Zurück kommt ein JSON mit den Schichten, den Verstößen in beiden Sichten, den Prognosen und den nicht bewertbaren Zeiträumen, das Sie direkt weiterverarbeiten können.
Für eine ganze Flotte auf einmal gibt es einen Batch-Endpunkt. Sie laden alle Dateien in einer Anfrage hoch, der Container sortiert sie selbst nach Fahrerkarte und rechnet im Hintergrund. Den Fortschritt und die Ergebnisse je Fahrer fragen Sie über eine Job-ID ab.
Gleicher Kern
Desktop-Programm und API rechnen mit demselben Code. Was Sie im Programm sehen, liefert die API als Daten, mit denselben Ergebnissen.
Zwei Sichten
Jede Auswertung enthält beide Verstoßlisten. Die Referenz-Sicht ist am Ergebnis etablierter Software kalibriert, die strenge Sicht leitet jeden Befund aus dem Verordnungstext ab und nennt den Artikel dazu. Ein eigener Endpunkt liefert den Katalog aller 24 Regeln mit ihren Fundstellen.
Berichte
Der Bericht aus dem Desktop-Programm kommt auch über die API, als HTML, als CSV-Tabellen im Zip oder als PDF. Dazu ein Herkunftsnachweis, der festhält, welche hochgeladene Datei welchen Tag belegt.
Echtheit
Signaturen und Zertifikate einer Fahrerkarte oder eines Fahrzeugeinheiten-Downloads lassen sich über die API prüfen. Die Antwort sagt, was verifiziert wurde und was sich bei älteren Kartengenerationen prinzipiell nicht prüfen lässt.
Fahrzeugeinheit
Auch die Download-Datei des Fahrzeugs lässt sich einlesen. Sie sehen, welche Karten in einem Zeitraum gesteckt haben und welche Fahrer damit gefahren sind.
OpenAPI
Die Schnittstelle ist als OpenAPI-3.1-Spezifikation beschrieben, die der Container selbst ausliefert. Die Dokumentation unter docs.scernetta.com wird direkt daraus erzeugt und kann deshalb nicht vom Stand der API abweichen.
Lizenz
Die API wird pro Fahrer oder pro Fahrzeug lizenziert und jährlich abgerechnet. Das Lizenz-Token prüft der Container offline, er muss uns dafür nie erreichen. Läuft die Lizenz ab, rechnet er noch 14 Tage weiter, damit eine späte Verlängerung keine Flotte anhält. Den Preis nennen wir auf Anfrage, weil er von der Größe der Flotte abhängt.
On-Prem
Die Kartendaten werden On-Prem verarbeitet, also in Ihrem Netzwerk. Das Einzige, was den Container je verlässt, sind Zähler ohne Namen und ohne Kartendaten, und auch die schicken Sie selbst.
Die Dokumentation der Schnittstelle liegt unter docs.scernetta.com und wird aus der OpenAPI-Datei erzeugt. Sie beginnt mit einem Leitfaden zu Start, Lizenz und Fehlerbehandlung und beschreibt jeden Endpunkt mit seinen Parametern.Zur Dokumentation
Wenn Sie die API einsetzen wollen, schreiben Sie uns, welche Systeme Sie anbinden möchten und um wie viele Fahrer oder Fahrzeuge es geht. Wir melden uns dann mit einem Zugang.