Samme analyse som On-Prem-container i Deres netværk
API'en er den samme analysekerne som i desktop-programmet, pakket som container-image, som De driver On-Prem, altså på Deres egen server eller i Deres cluster. Deres systemer sender kortfilerne via HTTP til containeren og får analysen tilbage som JSON. Containeren holder kun kortfilerne i arbejdshukommelsen. Den gemmer dem ikke på harddisken og skriver dem ikke i nogen logfil. Kortfiler og resultater sender den ikke til os. For at vi kan tælle, hvor mange førere De analyserer med Deres licens, forbinder den sig til vores licensserver på license.scernetta.com, og det sker efter starten, cirka hver 6. time og ved en ny fører. Licensserveren modtager herved teksten i Deres licensfil med Deres virksomhedsnavn, containerens versionsnummer, nogle tekniske kontrolværdier og en førerkode for hver ny fører. Førerkoden beregner containeren på Deres server ud fra førerkortet og Deres hemmelige nøgle.
Hvem det er tænkt til
Det er tænkt til flåder med eget TMS eller ERP, der vil viderebehandle analysen dér. Telematikleverandører, der i forvejen indsamler kortdata, kan få dem kontrolleret direkte, og tjenesteudbydere, der analyserer førerkort for mange kunder, sparer omvejen gennem et desktop-program.
Sådan foregår det
De får en licensfil fra os. Før den første start opretter De én gang en hemmelig nøgle med en kommando fra container-imaget, og ud fra nøglen beregner containeren førerkoderne. Brug denne nøgle på alle installationer, og opbevar en kopi af den. Containeren kører på en server i Deres netværk og skal dér have sin egen mappe, hvor den registrerer, hvilke førere der allerede har en førerplads. Serveren skal kunne nå license.scernetta.com, direkte eller via Deres HTTP-proxy. Deres systemer logger på med en API-nøgle og afleverer .ddd-filerne via HTTP, enkeltvis eller samlet pr. fører, og containeren sammenlægger dem præcis som desktop-programmet gør. Tilbage kommer en JSON med vagterne, overtrædelserne i den valgte visning, prognoserne og de perioder, der ikke kan vurderes, som De kan viderebehandle direkte.
Til en hel flåde på én gang findes der et batch-endpoint. De uploader alle filer i én forespørgsel, containeren knytter dem selv til de rigtige førere og regner i baggrunden. For hver ny fører i forespørgslen optager containeren en førerplads allerede ved indsendelsen. Rækker de ledige førerpladser ikke til alle nye førere, afviser den hele forespørgslen og optager ingen plads. Fremdriften og resultaterne pr. fører henter De via et job-id.
Samme kerne
Desktop-programmet og API'en regner med den samme kode. For den samme fil og den samme visning leverer API'en de samme resultater som programmet, som data.
To visninger
Hvert svar indeholder en af de to overtrædelseslister. Som standard bruges den strenge visning, der udleder hvert fund af forordningsteksten og nævner den tilhørende artikel. Efter EU-retten kan De i stedet hente referencevisningen, der er kalibreret efter resultatet fra etableret software. Efter de schweiziske regler ARV 1 og ARV 2 findes kun den strenge visning. Et selvstændigt endpoint leverer kataloget over reglerne med deres henvisninger.
Rapporter
Rapporten fra desktop-programmet kommer også via API'en, som HTML eller som CSV-tabeller i et zip. Dertil et kildemanifest, der fastholder, hvilken uploadet fil der dækker hvilken dag.
Ægthed
Signaturer og certifikater fra et førerkort eller en udlæsning fra en køretøjsenhed kan kontrolleres via API'en. Svaret siger, hvad der blev verificeret. Signaturer fra den første kortgeneration kontrollerer denne version endnu ikke, hvilket ikke er et tegn på manipulation.
Køretøjsenhed
Også køretøjets udlæsningsfil kan indlæses. De ser, hvilke kort der var isat i en periode, og hvilke førere der kørte med dem.
Generationer
Der læses førerkort af generation 1 samt generation 2 inklusive version 2. Filer fra køretøjsenheder læser API'en kun i formaterne for generation 2.
OpenAPI
Grænsefladen er beskrevet som en OpenAPI-3.1-specifikation, som containeren selv leverer. Dokumentationen på docs.scernetta.com dannes ud fra den.
Sådan tælles førere
Hvert førerkort, De analyserer i løbet af licensens løbetid, tæller én gang som fører, uanset hvor ofte De analyserer det. Får en fører et fornyet kort eller et erstatningskort, er det fortsat den samme fører. Får føreren et kort fra et andet land, tæller vedkommende som ny fører. En fører beholder sin førerplads indtil løbetidens udløb, også hvis føreren forlader Deres virksomhed inden da. Der tælles samlet på tværs af alle Deres installationer, herunder også en testinstallation. Eksempelkortet fra vores hjemmeside, ægthedskontrollen og filer fra køretøjsenheder optager ingen førerplads.
Licens
API'en licenseres efter antallet af førere og afregnes årligt. Om licensfilen er ægte, kontrollerer containeren selv ud fra dens digitale signatur, og det kræver ingen forbindelse til os. Analyseres en fører for første gang i løbetiden, beder containeren vores licensserver om en førerplads til føreren. Udløber en betalt licens, regner containeren videre i 14 dage, så analysen ikke går i stå, hvis forlængelsen kommer et par dage for sent. Prisen oplyser vi på forespørgsel, fordi den afhænger af flådens størrelse.
Uden forbindelse til licensserveren
Førere, der allerede har en førerplads, analyserer containeren fortsat, også uden forbindelse til vores licensserver, i 30 dage fra den seneste forbindelse og med en prøvelicens i 14 dage. Til nye førere har en betalt licens en reserve, hvis vores licensserver ikke kan nås i mere end et minut. Reserven er en tiendedel af førerpladserne, dog mindst 2 pladser pr. løbetid, ved 30 pladser altså 3. Til det skal containeren have sin mappe på serveren. Disse førere indberetter den efterfølgende, så snart licensserveren kan nås igen. En prøvelicens har ingen reserve.
Hvad der forlader serveren
Kortfilerne behandles On-Prem, altså i Deres netværk, og overføres aldrig til os. Førerkoden beregner containeren på Deres server ud fra førerkortet og Deres hemmelige nøgle, som vi aldrig modtager. Vi kan ikke se ud fra koden, hvem føreren er. Med Deres nøgle kan koden dog knyttes til en fører igen, og derfor er førerkoden en personoplysning efter GDPR. De seneste 20 beskeder, som containeren har sendt til vores licensserver siden sin start, kan De hente fra containeren og læse, sådan som de så ud før krypteringen.
Dokumentationen af grænsefladen ligger på docs.scernetta.com og dannes ud fra OpenAPI-filen. Den begynder med en vejledning til opstart, licens og fejlhåndtering og beskriver hvert endpoint med dets parametre.Til dokumentationen
Vil De bruge API'en, så skriv til os, hvilke systemer De vil forbinde, og hvor mange førere eller køretøjer det drejer sig om. Så vender vi tilbage med en adgang.