Samma analys som On-Prem-Container i ert nätverk
API:et är samma analyskärna som i skrivbordsprogrammet, förpackad som en Container-image som ni driver On-Prem, alltså på en egen server eller i ert kluster. Era system skickar kortfilerna via HTTP till Containern och får analysen tillbaka som JSON. Containern håller kortfilerna endast i arbetsminnet. Den sparar dem inte på hårddisken och skriver dem inte till någon loggfil. Kortfiler och resultat skickar den inte till oss. För att vi ska kunna räkna hur många förare ni analyserar med er licens ansluter den till vår licensserver på license.scernetta.com, och det gör den efter starten, ungefär var 6:e timme och när en ny förare tillkommer. Licensservern får då texten i er licensfil med ert företagsnamn, Containerns versionsnummer, några tekniska kontrollvärden och en förarkod för varje ny förare. Förarkoden beräknar Containern på er server utifrån förarkortet och er hemliga nyckel.
Vem det är avsett för
Det är avsett för flottor med eget TMS eller ERP som vill bearbeta analysen vidare där. Telematikleverantörer som ändå redan samlar in kortdata kan låta kontrollera dem direkt, och tjänsteleverantörer som analyserar förarkort åt många kunder slipper omvägen via ett skrivbordsprogram.
Så går det till
Ni får en licensfil av oss. Före den första starten skapar ni en gång en hemlig nyckel med ett kommando från Container-imagen. Ur den nyckeln beräknar Containern förarkoderna. Använd denna nyckel på alla installationer och spara en kopia. Containern körs på en server i ert nätverk och behöver där en egen mapp för att hålla reda på vilka förare som redan har en förarplats. Servern måste kunna nå license.scernetta.com, direkt eller via er HTTP-proxy. Era system autentiserar sig med en API-nyckel och lämnar över .ddd-filerna via HTTP, enstaka eller buntade per förare, och Containern sammanför dem precis som skrivbordsprogrammet gör. Tillbaka kommer en JSON med passen, överträdelserna i den valda vyn, prognoserna och de perioder som inte kan bedömas, som ni kan bearbeta vidare direkt.
För en hel flotta på en gång finns en batch-slutpunkt. Ni laddar upp alla filer i en förfrågan, Containern fördelar dem själv på förarna och räknar i bakgrunden. För varje ny förare i förfrågan tar Containern en förarplats i anspråk redan när förfrågan lämnas in. Räcker de lediga förarplatserna inte till för alla nya förare, avvisar den hela förfrågan och tar ingen plats i anspråk. Förloppet och resultaten per förare hämtar ni via ett jobb-ID.
Samma kärna
Skrivbordsprogrammet och API:et räknar med samma kod. För samma fil och samma vy levererar API:et samma resultat som programmet, som data.
Två vyer
Varje svar innehåller en av de två överträdelselistorna. Som standard levereras den strikta vyn, som härleder varje fynd ur förordningstexten och anger tillhörande artikel. Enligt EU-rätten kan ni i stället begära referensvyn, som är kalibrerad mot resultatet från etablerad programvara. Enligt de schweiziska reglerna ARV 1 och ARV 2 finns endast den strikta vyn. En egen slutpunkt levererar katalogen över reglerna med deras lagrum.
Rapporter
Rapporten från skrivbordsprogrammet kommer även via API:et, som HTML eller som CSV-tabeller i en zip. Därtill ett källmanifest som fastställer vilken uppladdad fil som styrker vilken dag.
Äkthet
Signaturer och certifikat på ett förarkort eller en nedladdning från en fordonsenhet kan kontrolleras via API:et. Svaret anger vad som verifierats. Signaturer från den första kortgenerationen kontrollerar denna version ännu inte, det är ingen indikation på manipulation.
Fordonsenhet
Även fordonets nedladdningsfil kan läsas in. Ni ser vilka kort som satt i under en period och vilka förare som körde med dem.
Generationer
Förarkort av generation 1 samt generation 2 inklusive version 2 läses. Filer från fordonsenheter läser API:et endast i formaten för generation 2.
OpenAPI
Gränssnittet är beskrivet som en OpenAPI-3.1-specifikation som Containern själv levererar. Dokumentationen på docs.scernetta.com skapas ur den.
Hur förare räknas
Varje förarkort som ni analyserar under löptiden för er licens räknas en gång som förare, oavsett hur ofta ni analyserar det. Får en förare ett förnyat kort eller ett ersättningskort är det fortfarande samma förare. Får föraren ett kort från ett annat land räknas föraren som en ny förare. En förare behåller sin förarplats till löptidens slut, även om föraren lämnar ert företag dessförinnan. Räkningen omfattar alla era installationer tillsammans, även en testinstallation. Exempelkortet från vår webbplats, äkthetskontrollen och filer från fordonsenheter tar ingen förarplats i anspråk.
Licens
API:et licensieras efter antalet förare och faktureras årligen. Om licensfilen är äkta kontrollerar Containern själv utifrån dess digitala signatur, för det behöver den ingen förbindelse till oss. När en förare analyseras för första gången under löptiden begär Containern en förarplats för föraren hos vår licensserver. Löper en betald licens ut räknar Containern vidare i ytterligare 14 dagar, så att analysen inte stannar om förlängningen kommer några dagar senare. Priset anger vi på begäran, eftersom det beror på flottans storlek.
Utan förbindelse till licensservern
Förare som redan har en förarplats fortsätter Containern att analysera även utan förbindelse till vår licensserver, i 30 dagar från den senaste förbindelsen, med en testlicens i 14 dagar. För nya förare har en betald licens en reserv för det fall att vår licensserver inte kan nås under mer än en minut. Reserven är en tiondel av förarplatserna, men minst 2 platser per löptid, vid 30 platser alltså 3. För detta behöver Containern sin mapp på servern. Dessa förare rapporterar den i efterhand, så snart licensservern kan nås igen. En testlicens har ingen reserv.
Vad som lämnar servern
Kortfilerna behandlas On-Prem, alltså i ert nätverk, och överförs aldrig till oss. Förarkoden beräknar Containern på er server utifrån förarkortet och er hemliga nyckel, som vi aldrig får. Vi kan inte utläsa ur koden vem föraren är. Med er nyckel kan koden dock kopplas tillbaka till en förare, och därför utgör förarkoden en personuppgift enligt GDPR. De senaste 20 meddelandena som Containern har skickat till vår licensserver sedan sin start kan ni hämta från Containern och läsa, så som de såg ut före krypteringen.
Dokumentationen av gränssnittet finns på docs.scernetta.com och skapas ur OpenAPI-filen. Den börjar med en vägledning om start, licens och felhantering och beskriver varje slutpunkt med sina parametrar.Till dokumentationen
Om ni vill använda API:et, skriv till oss vilka system ni vill koppla in och hur många förare eller fordon det gäller. Vi hör då av oss med en åtkomst.