Den samme analysen, som On-Prem-Container i nettverket ditt
API-et er den samme analysekjernen som i skrivebordsprogrammet, pakket som container-image som du driver On-Prem, altså på en egen server eller i klyngen din. Systemene dine sender kortfilene til containeren via HTTP og får analysen tilbake som JSON. Containeren holder kortfilene bare i arbeidsminnet. Den lagrer dem ikke på disken og skriver dem ikke til noen loggfil. Kortfiler og resultater sender den ikke til oss. For at vi skal kunne telle hvor mange sjåfører du analyserer med lisensen din, kobler den seg til lisensserveren vår på license.scernetta.com. Det skjer etter oppstart, omtrent hver 6. time og når en ny sjåfør kommer til. Lisensserveren mottar da teksten i lisensfilen din med firmanavnet ditt, versjonsnummeret til containeren, noen tekniske kontrollverdier og en sjåførkode for hver ny sjåfør. Sjåførkoden beregner containeren på serveren din ut fra sjåførkortet og den hemmelige nøkkelen din.
Hvem det er ment for
Dette er ment for flåter med eget TMS eller ERP som vil bearbeide analysen videre der. Telematikkleverandører som uansett allerede samler inn kortdata, kan få dem kontrollert direkte, og tjenesteleverandører som analyserer sjåførkort for mange kunder, slipper omveien om et skrivebordsprogram.
Slik foregår det
Du får en lisensfil av oss. Før første oppstart lager du én gang en hemmelig nøkkel med en kommando fra container-imaget, og ut fra denne nøkkelen beregner containeren sjåførkodene. Bruk denne nøkkelen på alle installasjonene og ta vare på en kopi. Containeren kjører på en server i nettverket ditt og trenger en egen mappe der. I denne mappen holder den oversikt over hvilke sjåfører som allerede har en sjåførplass. Serveren må kunne nå license.scernetta.com, direkte eller via HTTP-proxyen din. Systemene dine logger seg på med en API-nøkkel og overleverer .ddd-filene via HTTP, enkeltvis eller samlet per sjåfør, og containeren slår dem sammen på nøyaktig samme måte som skrivebordsprogrammet gjør. Tilbake kommer en JSON med skiftene, overtredelsene i den valgte visningen, prognosene og tidsrommene som ikke kan vurderes, som du kan bearbeide videre med det samme.
For en hel flåte på én gang finnes det et batch-endepunkt. Du laster opp alle filene i én forespørsel, containeren knytter dem selv til sjåførene og regner i bakgrunnen. For hver ny sjåfør i forespørselen tar containeren i bruk en sjåførplass allerede ved innsendingen. Er det ikke nok ledige sjåførplasser til alle de nye sjåførene, avviser den hele forespørselen og tar ingen plass i bruk. Fremdriften og resultatene per sjåfør henter du via en jobb-ID.
Samme kjerne
Skrivebordsprogrammet og API-et regner med den samme koden. For den samme filen og den samme visningen leverer API-et de samme resultatene som programmet, som data.
To visninger
Hvert svar inneholder én av de to overtredelseslistene. Standard er den strenge visningen, som utleder hvert funn fra forordningsteksten og oppgir hvilken artikkel funnet bygger på. Etter EU-retten kan du i stedet hente referansevisningen, som er kalibrert mot resultatet fra etablert programvare. Etter de sveitsiske reglene ARV 1 og ARV 2 finnes bare den strenge visningen. Et eget endepunkt leverer katalogen over reglene med kildehenvisningene deres.
Rapporter
Rapporten fra skrivebordsprogrammet kommer også via API-et, som HTML eller som CSV-tabeller i en zip. I tillegg et kildemanifest som viser hvilken opplastet fil som dekker hvilken dag.
Ekthet
Signaturer og sertifikater i et sjåførkort eller i en nedlasting fra en kjøretøyenhet kan kontrolleres via API-et. Svaret sier hva som ble verifisert. Signaturer fra den første kortgenerasjonen kontrollerer denne versjonen ennå ikke, og det er ingen indikasjon på manipulasjon.
Kjøretøyenhet
Også nedlastingsfilen fra kjøretøyet kan leses inn. Du ser hvilke kort som var satt inn i et tidsrom og hvilke sjåfører som kjørte med dem.
Generasjoner
Sjåførkort av generasjon 1 samt generasjon 2, inkludert versjon 2, leses. Filer fra kjøretøyenheter leser API-et bare i formatene for generasjon 2.
OpenAPI
Grensesnittet er beskrevet som en OpenAPI-3.1-spesifikasjon som containeren selv leverer. Dokumentasjonen på docs.scernetta.com genereres fra den.
Slik telles sjåfører
Hvert sjåførkort du analyserer i lisensperioden, teller én gang som sjåfør, uansett hvor ofte du analyserer det. Får en sjåfør et fornyet kort eller et erstatningskort, er det fortsatt den samme sjåføren. Får sjåføren et kort fra et annet land, teller sjåføren som en ny sjåfør. En sjåfør beholder sjåførplassen sin til lisensperioden er slutt, også om sjåføren forlater virksomheten din før det. Det telles på tvers av alle installasjonene dine samlet, også en testinstallasjon. Eksempelkortet fra nettsiden vår, ekthetskontrollen og filer fra kjøretøyenheter tar ingen sjåførplass i bruk.
Lisens
API-et lisensieres etter antall sjåfører og faktureres årlig. Om lisensfilen er ekte, kontrollerer containeren selv ut fra den digitale signaturen, og til det trenger den ingen forbindelse til oss. Blir en sjåfør analysert for første gang i lisensperioden, ber containeren lisensserveren vår om en sjåførplass for sjåføren. Går en betalt lisens ut, regner containeren videre i 14 dager til, slik at analysen ikke stopper opp når fornyelsen kommer noen dager senere. Prisen oppgir vi på forespørsel, fordi den avhenger av størrelsen på flåten.
Uten forbindelse til lisensserveren
Sjåfører som allerede har en sjåførplass, analyserer containeren videre også uten forbindelse til lisensserveren vår, i 30 dager fra siste forbindelse, med en prøvelisens i 14 dager. For nye sjåfører har en betalt lisens en reserve i tilfelle lisensserveren vår ikke kan nås i mer enn ett minutt. Reserven er en tiendedel av sjåførplassene, men minst 2 plasser per lisensperiode, ved 30 plasser altså 3. Til det trenger containeren mappen sin på serveren. Disse sjåførene melder den inn i etterkant så snart lisensserveren kan nås igjen. En prøvelisens har ingen reserve.
Hva som forlater serveren
Kortfilene behandles On-Prem, altså i nettverket ditt, og overføres aldri til oss. Sjåførkoden beregner containeren på serveren din ut fra sjåførkortet og den hemmelige nøkkelen din, som vi aldri mottar. Vi kan ikke lese ut av koden hvem sjåføren er. Med nøkkelen din kan koden likevel knyttes til en sjåfør igjen, og derfor er sjåførkoden en personopplysning etter GDPR. De siste 20 meldingene som containeren har sendt til lisensserveren vår siden oppstart, kan du hente fra containeren og lese slik de så ut før krypteringen.
Dokumentasjonen av grensesnittet ligger på docs.scernetta.com og genereres fra OpenAPI-filen. Den begynner med en veiledning om oppstart, lisens og feilhåndtering og beskriver hvert endepunkt med parameterne sine.Til dokumentasjonen
Vil du ta i bruk API-et, skriv til oss hvilke systemer du ønsker å koble til og hvor mange sjåfører eller kjøretøy det gjelder. Da tar vi kontakt og gir deg en tilgang.