Ista analiza kot On-Prem Container v vašem omrežju
API je isto analitsko jedro kot v namiznem programu, zapakirano kot slika za Container, ki jo poganjate On-Prem, torej na lastnem strežniku ali v svoji gruči. Vaši sistemi datoteke kartic pošljejo v Container prek HTTP in dobijo analizo nazaj kot JSON. Container datoteke kartic hrani samo v delovnem pomnilniku. Ne shranjuje jih na disk in jih ne zapisuje v nobeno dnevniško datoteko. Datotek kartic in rezultatov nam ne pošilja. Da lahko preštejemo, koliko voznikov analizirate s svojo licenco, se poveže z našim licenčnim strežnikom na license.scernetta.com, in sicer po zagonu, približno vsakih 6 ur in ko se pojavi nov voznik. Licenčni strežnik pri tem prejme besedilo vaše licenčne datoteke z imenom vašega podjetja, številko različice Containerja, nekaj tehničnih kontrolnih vrednosti in za vsakega novega voznika kodo voznika. Kodo voznika Container izračuna na vašem strežniku iz vozniške kartice in vašega tajnega ključa.
Komu je namenjeno
Namenjeno je voznim parkom z lastnim TMS ali ERP, ki želijo analizo tam naprej obdelati. Ponudniki telematike, ki podatke kartic tako ali tako že zbirajo, jih lahko dajo neposredno preveriti, ponudniki storitev, ki vozniške kartice analizirajo za veliko strank, pa si prihranijo ovinek prek namiznega programa.
Kako poteka
Od nas prejmete licenčno datoteko. Pred prvim zagonom z ukazom iz slike za Container enkrat ustvarite tajni ključ, iz katerega Container izračunava kode voznikov. Ta ključ uporabite na vseh namestitvah in shranite njegovo kopijo. Container teče na strežniku v vašem omrežju in tam potrebuje lastno mapo, v kateri beleži, kateri vozniki že imajo vozniško mesto. Strežnik mora imeti dostop do license.scernetta.com, neposredno ali prek vašega posredniškega strežnika HTTP. Vaši sistemi se prijavijo s ključem API in predajo datoteke .ddd prek HTTP, posamično ali združeno po voznikih, in Container jih združi natanko tako, kot to počne namizni program. Nazaj pride JSON z izmenami, kršitvami v izbranem pogledu, napovedmi in obdobji, ki jih ni mogoče oceniti, ta odgovor pa lahko neposredno obdelate naprej.
Za cel vozni park naenkrat obstaja paketna končna točka (batch). Vse datoteke naložite v eni zahtevi, Container jih sam dodeli voznikom in računa v ozadju. Za vsakega novega voznika v zahtevi Container zasede vozniško mesto že ob oddaji. Če prostih vozniških mest ni dovolj za vse nove voznike, zavrne celotno zahtevo in ne zasede nobenega mesta. Napredek in rezultate za posameznega voznika poizvedujete prek ID-ja opravila (Job-ID).
Isto jedro
Namizni program in API računata z isto kodo. API za isto datoteko in isti pogled poda enake rezultate kot program, in sicer v obliki podatkov.
Dva pogleda
Vsak odgovor vsebuje enega od obeh seznamov kršitev. Privzeto je nastavljen strogi pogled, ki vsako ugotovitev izpelje iz besedila uredbe in navede pripadajoči člen. Po pravu EU lahko namesto tega zahtevate referenčni pogled, ki je umerjen glede na rezultate uveljavljene programske opreme. Po švicarskih pravilih ARV 1 in ARV 2 obstaja samo strogi pogled. Posebna končna točka poda katalog pravil z njihovimi sklici.
Poročila
Poročilo iz namiznega programa je na voljo tudi prek API, kot HTML ali kot razpredelnice CSV v datoteki Zip. Zraven še seznam virov, ki beleži, katera naložena datoteka podpira kateri dan.
Pristnost
Podpise in certifikate vozniške kartice ali prenosa enote v vozilu je mogoče preveriti prek API. Odgovor pove, kaj je bilo preverjeno. Podpisov prve generacije kartic ta različica še ne preverja, kar ni znak prirejanja.
Enota v vozilu
Prebrati je mogoče tudi datoteko prenosa vozila. Vidite, katere kartice so bile v določenem obdobju vstavljene in kateri vozniki so z njimi vozili.
Generacije
Berejo se vozniške kartice generacije 1 ter generacije 2, vključno z različico 2. Datoteke enot v vozilu API bere samo v formatih generacije 2.
OpenAPI
Vmesnik je opisan kot specifikacija OpenAPI 3.1, ki jo Container sam ponudi. Dokumentacija na docs.scernetta.com se ustvari iz nje.
Kako se štejejo vozniki
Vsaka vozniška kartica, ki jo analizirate v obdobju veljavnosti licence, šteje enkrat kot voznik, ne glede na to, kolikokrat jo analizirate. Če voznik dobi obnovljeno ali nadomestno kartico, ostane isti voznik. Če dobi kartico iz druge države, šteje kot nov voznik. Svoje vozniško mesto voznik obdrži do konca obdobja veljavnosti, tudi če pred tem zapusti vaše podjetje. Šteje se skupaj prek vseh vaših namestitev, vključno s testno namestitvijo. Vozniškega mesta ne zasedejo vzorčna kartica z naše spletne strani, preverjanje pristnosti in datoteke enot v vozilu.
Licenca
API se licencira glede na število voznikov in obračunava letno. Ali je licenčna datoteka pristna, Container preveri sam po njenem digitalnem podpisu, za to ne potrebuje povezave z nami. Ko je voznik v obdobju veljavnosti prvič analiziran, Container pri našem licenčnem strežniku zaprosi za vozniško mesto zanj. Ko plačana licenca poteče, Container računa še 14 dni naprej, da se analiza ne ustavi, če podaljšanje pride nekaj dni pozneje. Ceno navedemo na zahtevo, ker je odvisna od velikosti voznega parka.
Brez povezave z licenčnim strežnikom
Voznike, ki že imajo vozniško mesto, Container analizira naprej tudi brez povezave z našim licenčnim strežnikom, 30 dni od zadnje povezave, s preizkusno licenco 14 dni. Za nove voznike ima plačana licenca rezervo za primer, da naš licenčni strežnik dlje kot eno minuto ni dosegljiv. Rezerva znaša desetino vozniških mest, vendar najmanj 2 mesti na obdobje veljavnosti, pri 30 mestih torej 3. Za to Container potrebuje svojo mapo na strežniku. Te voznike naknadno sporoči, ko je licenčni strežnik spet dosegljiv. Preizkusna licenca nima rezerve.
Kaj zapusti strežnik
Datoteke kartic se obdelujejo On-Prem, torej v vašem omrežju, in se nikoli ne prenesejo k nam. Kodo voznika Container izračuna na vašem strežniku iz vozniške kartice in vašega tajnega ključa, ki ga nikoli ne prejmemo. Iz kode ne moremo razbrati, kdo je voznik. Z vašim ključem pa je kodo mogoče znova pripisati vozniku, zato po GDPR spada med osebne podatke. Zadnjih 20 sporočil, ki jih je Container od zagona poslal našemu licenčnemu strežniku, lahko prikličete iz Containerja in jih preberete v obliki, kakršno so imela pred šifriranjem.
Dokumentacija vmesnika je na docs.scernetta.com in se ustvari iz datoteke OpenAPI. Začne se z vodnikom za zagon, licenco in obravnavo napak ter opiše vsako končno točko z njenimi parametri.Na dokumentacijo
Če želite uporabljati API, nam pišite, katere sisteme želite povezati in za koliko voznikov ali vozil gre. Nato se oglasimo z dostopom.