Rovnaké vyhodnotenie ako On-Prem Container vo vašej sieti
API je rovnaké jadro vyhodnotenia ako v desktopovom programe, zabalené ako Container image, ktorý prevádzkujete On-Prem, teda na vlastnom serveri alebo vo svojom klastri. Vaše systémy posielajú súbory kariet do Containera cez HTTP a dostanú vyhodnotenie späť ako JSON. Container uchováva súbory kariet len v operačnej pamäti. Neukladá ich na disk a nezapisuje ich do žiadneho protokolového súboru. Súbory kariet ani výsledky nám neposiela. Aby sme mohli spočítať, koľko vodičov s vašou licenciou vyhodnocujete, spája sa s naším licenčným serverom na license.scernetta.com, a to po spustení, približne každých 6 hodín a vtedy, keď pribudne nový vodič. Licenčný server pritom dostáva text vášho licenčného súboru s názvom vašej firmy, číslo verzie Containera, niekoľko technických kontrolných hodnôt a za každého nového vodiča kód vodiča. Kód vodiča vypočíta Container na vašom serveri z karty vodiča a vášho tajného kľúča.
Pre koho je to určené
Je to určené flotilám s vlastným TMS alebo ERP, ktoré chcú vyhodnotenie ďalej spracúvať práve tam. Poskytovatelia telematiky, ktorí údaje z kariet aj tak už zbierajú, ich môžu nechať priamo skontrolovať, a poskytovatelia služieb, ktorí vyhodnocujú karty vodičov pre mnohých zákazníkov, si ušetria obchádzku cez desktopový program.
Ako to prebieha
Od nás dostanete licenčný súbor. Pred prvým spustením jedenkrát vytvoríte príkazom z Container image tajný kľúč, z ktorého Container vypočítava kódy vodičov. Tento kľúč používajte vo všetkých inštaláciách a uschovajte si jeho kópiu. Container beží na serveri vo vašej sieti a potrebuje tam vlastný priečinok, v ktorom si zaznamenáva, ktorí vodiči už majú vodičské miesto. Server musí mať prístup na license.scernetta.com, priamo alebo cez váš HTTP proxy server. Vaše systémy sa prihlasujú kľúčom API a odovzdávajú .ddd súbory cez HTTP, jednotlivo alebo zviazané po vodičoch, a Container ich zlúči presne tak, ako to robí desktopový program. Späť príde JSON so zmenami, s porušeniami vo zvolenom pohľade, s prognózami a s obdobiami, ktoré sa nedajú vyhodnotiť. Ten môžete priamo ďalej spracovať.
Pre celú flotilu naraz existuje dávkový koncový bod. Všetky súbory nahráte v jednej požiadavke, Container ich sám priradí k vodičom a spracuje na pozadí. Za každého nového vodiča v požiadavke obsadí Container vodičské miesto už pri jej podaní. Ak voľné vodičské miesta nestačia pre všetkých nových vodičov, odmietne celú požiadavku a neobsadí žiadne vodičské miesto. Priebeh a výsledky za jednotlivých vodičov zisťujete cez ID úlohy.
Rovnaké jadro
Desktopový program a API počítajú s rovnakým kódom. Pre ten istý súbor a ten istý pohľad dodá API rovnaké výsledky ako program, vo forme údajov.
Dva pohľady
Každá odpoveď obsahuje jeden z dvoch zoznamov porušení. Predvolený je prísny pohľad, ktorý odvodzuje každé zistenie zo znenia nariadenia a uvádza k nemu článok. Podľa práva EÚ si môžete namiesto neho vyžiadať referenčný pohľad, ktorý je kalibrovaný na výsledok zavedeného softvéru. Podľa švajčiarskych predpisov ARV 1 a ARV 2 existuje len prísny pohľad. Samostatný koncový bod dodá katalóg pravidiel s ich odkazmi na zdroj.
Správy
Správa z desktopového programu je dostupná aj cez API, ako HTML alebo ako CSV tabuľky v zipe. K tomu manifest zdrojov, ktorý zachytáva, ktorý nahraný súbor dokladá ktorý deň.
Pravosť
Podpisy a certifikáty karty vodiča alebo stiahnutia z jednotky vozidla sa dajú overiť cez API. Odpoveď uvádza, čo sa overilo. Podpisy prvej generácie kariet táto verzia zatiaľ neoveruje, nie je to náznak manipulácie.
Jednotka vozidla
Načítať sa dá aj stiahnutý súbor vozidla. Vidíte, ktoré karty boli v danom období vložené a ktorí vodiči s nimi jazdili.
Generácie
Čítajú sa karty vodičov generácie 1, ako aj generácie 2 vrátane verzie 2. Súbory z jednotiek vozidiel API číta len vo formátoch generácie 2.
OpenAPI
Rozhranie je opísané ako špecifikácia OpenAPI 3.1, ktorú Container sám poskytuje. Dokumentácia na docs.scernetta.com sa z nej vytvára.
Ako sa počítajú vodiči
Každá karta vodiča, ktorú počas doby platnosti licencie vyhodnotíte, sa počíta raz ako jeden vodič, bez ohľadu na to, koľkokrát ju vyhodnotíte. Ak vodič dostane obnovenú alebo náhradnú kartu, zostáva tým istým vodičom. Ak dostane kartu z inej krajiny, počíta sa ako nový vodič. Svoje vodičské miesto si vodič ponechá do konca doby platnosti, aj keď z vášho podniku odíde skôr. Počíta sa za všetky vaše inštalácie spolu, vrátane testovacej inštalácie. Vodičské miesto neobsadzujú ukážková karta z našej webovej stránky, overenie pravosti ani súbory z jednotiek vozidiel.
Licencia
API sa licencuje podľa počtu vodičov a účtuje sa ročne. Či je licenčný súbor pravý, overuje Container sám podľa jeho digitálneho podpisu a nepotrebuje na to spojenie s nami. Keď sa vodič počas doby platnosti vyhodnocuje prvýkrát, Container požiada náš licenčný server o vodičské miesto pre tohto vodiča. Ak platená licencia vyprší, Container počíta ešte 14 dní ďalej, aby sa vyhodnocovanie nezastavilo, keď predĺženie príde o niekoľko dní neskôr. Cenu uvádzame na požiadanie, pretože závisí od veľkosti flotily.
Bez spojenia s licenčným serverom
Vodičov, ktorí už majú vodičské miesto, Container vyhodnocuje aj bez spojenia s naším licenčným serverom, a to 30 dní od posledného spojenia, so skúšobnou licenciou 14 dní. Pre nových vodičov má platená licencia rezervu pre prípad, že náš licenčný server nie je dostupný dlhšie ako jednu minútu. Rezerva predstavuje desatinu vodičských miest, najmenej však 2 vodičské miesta na dobu platnosti, pri 30 vodičských miestach teda 3. Na to potrebuje Container svoj priečinok na serveri. Týchto vodičov nahlási dodatočne, len čo je licenčný server opäť dostupný. Skúšobná licencia nemá žiadnu rezervu.
Čo opúšťa server
Súbory kariet sa spracúvajú On-Prem, teda vo vašej sieti, a nikdy sa nám neprenášajú. Kód vodiča vypočíta Container na vašom serveri z karty vodiča a vášho tajného kľúča, ktorý nikdy nedostaneme. Z kódu nedokážeme vyčítať, kto je vodič. S vaším kľúčom sa však kód dá opäť priradiť k vodičovi, preto kód vodiča podľa GDPR patrí medzi osobné údaje. Posledných 20 správ, ktoré Container od svojho spustenia poslal nášmu licenčnému serveru, si môžete z Containera vyžiadať a prečítať v podobe, akú mali pred zašifrovaním.
Dokumentácia rozhrania je na docs.scernetta.com a vytvára sa z OpenAPI súboru. Začína sprievodcom k spusteniu, licencii a spracovaniu chýb a opisuje každý koncový bod s jeho parametrami.Na dokumentáciu
Ak chcete API nasadiť, napíšte nám, ktoré systémy chcete pripojiť a o koľko vodičov alebo vozidiel ide. Následne sa vám ozveme s prístupom.