Ista analiza kao On-Prem Container u vašoj mreži
API je ista jezgra za analizu kao u desktop programu, upakirana kao Container image koji pokrećete On-Prem, dakle na vlastitom poslužitelju ili u svojem clusteru. Vaši sustavi šalju datoteke kartica u Container putem HTTP-a i vraća im se analiza kao JSON. Container datoteke kartica drži samo u radnoj memoriji. Ne pohranjuje ih na disk i ne zapisuje ih ni u jednu datoteku zapisnika. Datoteke kartica i rezultate ne šalje nama. Kako bismo mogli brojati koliko vozača analizirate svojom licencijom, povezuje se s našim licencnim poslužiteljem na license.scernetta.com, i to nakon pokretanja, otprilike svakih 6 sati i kod novog vozača. Licencni poslužitelj pritom dobiva tekst vaše licencne datoteke s nazivom vaše tvrtke, broj verzije Containera, nekoliko tehničkih kontrolnih vrijednosti i za svakog novog vozača jedan kôd vozača. Kôd vozača Container izračunava na vašem poslužitelju iz kartice vozača i vašeg tajnog ključa.
Za koga je namijenjeno
Namijenjeno je voznim parkovima s vlastitim TMS-om ili ERP-om koji analizu žele dalje obrađivati ondje. Pružatelji telematike koji ionako već prikupljaju podatke s kartica mogu ih tako izravno dati na provjeru, a pružatelji usluga koji analiziraju kartice vozača za mnogo klijenata štede si zaobilazni put preko desktop programa.
Kako to teče
Od nas dobivate licencnu datoteku. Prije prvog pokretanja jednokratno stvarate tajni ključ naredbom iz Container imagea. Iz tog ključa Container izračunava kôdove vozača. Upotrebljavajte taj ključ na svim instalacijama i čuvajte njegovu kopiju. Container radi na poslužitelju u vašoj mreži i ondje treba vlastitu mapu u kojoj bilježi koji vozači već imaju vozačko mjesto. Poslužitelj mora moći doseći license.scernetta.com, izravno ili preko vašeg HTTP proxyja. Vaši se sustavi prijavljuju API ključem i predaju .ddd datoteke putem HTTP-a, pojedinačno ili grupirano po vozaču, a Container ih objedinjuje jednako kao što to čini desktop program. Vraća se JSON sa smjenama, prekršajima u odabranom prikazu, prognozama i razdobljima koja nije moguće ocijeniti, koji možete izravno dalje obrađivati.
Za cijeli vozni park odjednom postoji batch endpoint. Sve datoteke prenosite u jednom zahtjevu, Container ih sam dodjeljuje vozačima i računa u pozadini. Za svakog novog vozača u zahtjevu Container zauzima vozačko mjesto već pri podnošenju zahtjeva. Ako slobodna vozačka mjesta nisu dovoljna za sve nove vozače, odbija cijeli zahtjev i ne zauzima nijedno mjesto. Napredak i rezultate po vozaču dohvaćate putem Job-ID-a.
Ista jezgra
Desktop program i API računaju istim kodom. Za istu datoteku i isti prikaz API isporučuje iste rezultate kao program, u obliku podataka.
Dva prikaza
Svaki odgovor sadrži jedan od dva popisa prekršaja. Zadano je postavljen strogi prikaz, koji svaki nalaz izvodi iz teksta uredbe i navodi pripadajući članak. Prema pravu EU-a umjesto njega možete zatražiti referentni prikaz, koji je kalibriran prema rezultatima etabliranog softvera. Prema švicarskim pravilima ARV 1 i ARV 2 postoji samo strogi prikaz. Zaseban endpoint isporučuje katalog pravila s pripadajućim člancima.
Izvješća
Izvješće iz desktop programa dostupno je i putem API-ja, kao HTML ili kao CSV tablice u Zip datoteci. Uz to i popis izvora koji bilježi koja prenesena datoteka pokriva koji dan.
Vjerodostojnost
Potpisi i certifikati kartice vozača ili preuzimanja jedinice u vozilu mogu se provjeriti putem API-ja. Odgovor govori što je provjereno. Potpise prve generacije kartica ova verzija još ne provjerava, što nije naznaka manipulacije.
Jedinica u vozilu
Može se učitati i datoteka preuzimanja vozila. Vidite koje su kartice u nekom razdoblju bile umetnute i koji su vozači s njima vozili.
Generacije
Čitaju se kartice vozača generacije 1 te generacije 2, uključujući verziju 2. Datoteke jedinica u vozilu API čita samo u formatima generacije 2.
OpenAPI
Sučelje je opisano kao OpenAPI 3.1 specifikacija koju Container sam isporučuje. Dokumentacija na docs.scernetta.com stvara se iz nje.
Kako se broje vozači
Svaka kartica vozača koju analizirate tijekom razdoblja važenja vaše licencije broji se jednom kao vozač, bez obzira na to koliko je često analizirate. Ako vozač dobije obnovljenu ili zamjensku karticu, ostaje isti vozač. Ako dobije karticu iz druge države, broji se kao novi vozač. Vozač zadržava svoje vozačko mjesto do kraja razdoblja važenja, čak i ako prije toga napusti vašu tvrtku. Broje se sve vaše instalacije zajedno, uključujući i testnu instalaciju. Vozačko mjesto ne zauzimaju primjer kartice s naše web-stranice, provjera vjerodostojnosti i datoteke jedinica u vozilu.
Licencija
API se licencira prema broju vozača i obračunava godišnje. Je li licencna datoteka vjerodostojna, Container sam provjerava prema njezinu digitalnom potpisu i za to mu nije potrebna veza s nama. Kada se vozač u razdoblju važenja prvi put analizira, Container od našeg licencnog poslužitelja traži vozačko mjesto za tog vozača. Kada plaćena licencija istekne, Container računa još 14 dana kako analiza ne bi stala ako produljenje stigne nekoliko dana kasnije. Cijenu navodimo na upit jer ovisi o veličini voznog parka.
Bez veze s licencnim poslužiteljem
Vozače koji već imaju vozačko mjesto Container nastavlja analizirati i bez veze s našim licencnim poslužiteljem, 30 dana od posljednje veze, a s probnom licencijom 14 dana. Za nove vozače plaćena licencija ima rezervu za slučaj da naš licencni poslužitelj nije dostupan dulje od jedne minute. Rezerva iznosi desetinu vozačkih mjesta, ali najmanje 2 mjesta po razdoblju važenja, dakle 3 kod 30 mjesta. Za to Container treba svoju mapu na poslužitelju. Te vozače naknadno prijavljuje čim licencni poslužitelj ponovno bude dostupan. Probna licencija nema rezervu.
Što napušta poslužitelj
Datoteke kartica obrađuju se On-Prem, dakle u vašoj mreži, i nikada se ne prenose nama. Kôd vozača Container izračunava na vašem poslužitelju iz kartice vozača i vašeg tajnog ključa, koji nikada ne dobivamo. Iz kôda ne možemo očitati tko je vozač. Pomoću vašeg ključa kôd se ipak može ponovno povezati s vozačem, zato prema GDPR-u spada u osobne podatke. Posljednjih 20 poruka koje je Container od svojeg pokretanja poslao našem licencnom poslužitelju možete dohvatiti u Containeru i pročitati, onako kako su izgledale prije šifriranja.
Dokumentacija sučelja nalazi se na docs.scernetta.com i stvara se iz OpenAPI datoteke. Počinje vodičem za pokretanje, licenciju i rukovanje pogreškama te opisuje svaki endpoint s njegovim parametrima.Na dokumentaciju
Ako želite koristiti API, javite nam koje sustave želite povezati i o koliko se vozača ili vozila radi. Zatim vam se javljamo s pristupom.