Stejné vyhodnocení jako On-Prem Container ve vaší síti
API je stejné vyhodnocovací jádro jako v desktopovém programu, zabalené jako Container Image, který provozujete On-Prem, tedy na vlastním serveru nebo ve vašem clusteru. Vaše systémy posílají soubory karet na Container přes HTTP a dostávají vyhodnocení zpět jako JSON. Container uchovává soubory karet pouze v operační paměti. Neukládá je na disk a nezapisuje je do žádného souboru protokolu. Soubory karet ani výsledky nám neposílá. Abychom mohli spočítat, kolik řidičů s vaší licencí vyhodnocujete, spojuje se s naším licenčním serverem na adrese license.scernetta.com, a to po spuštění, přibližně každých 6 hodin a když přibude nový řidič. Licenční server přitom dostává text vašeho licenčního souboru s názvem vaší firmy, číslo verze Containeru, několik technických kontrolních hodnot a pro každého nového řidiče kód řidiče. Kód řidiče vypočítá Container na vašem serveru z karty řidiče a vašeho tajného klíče.
Pro koho je to určeno
Je určeno pro vozové parky s vlastním TMS nebo ERP, které chtějí vyhodnocení dále zpracovávat právě tam. Poskytovatelé telematiky, kteří data z karet stejně už sbírají, je tak mohou nechat rovnou prověřit, a poskytovatelé služeb, kteří vyhodnocují karty řidičů pro mnoho zákazníků, si ušetří okliku přes desktopový program.
Jak to probíhá
Dostanete od nás licenční soubor. Před prvním spuštěním jednou vytvoříte příkazem z Container Image tajný klíč, ze kterého Container vypočítává kódy řidičů. Tento klíč používejte na všech instalacích a uschovejte si jeho kopii. Container běží na serveru ve vaší síti a potřebuje tam vlastní složku, do které si zaznamenává, kteří řidiči už mají řidičské místo. Server se musí umět spojit s license.scernetta.com, přímo nebo přes váš HTTP proxy server. Vaše systémy se přihlašují klíčem API a předávají soubory .ddd přes HTTP, jednotlivě nebo sdružené podle řidiče, a Container je sloučí přesně tak, jak to dělá desktopový program. Zpět přijde JSON se směnami, porušeními ve zvoleném pohledu, prognózami a s obdobími, která nelze vyhodnotit; to vše můžete rovnou dále zpracovat.
Pro celý vozový park najednou je k dispozici dávkový endpoint. Nahrajete všechny soubory v jednom požadavku, Container je sám přiřadí jednotlivým řidičům a počítá na pozadí. Pro každého nového řidiče v požadavku obsadí Container řidičské místo již při podání požadavku. Pokud volná řidičská místa nestačí pro všechny nové řidiče, odmítne celý požadavek a neobsadí žádné místo. Průběh a výsledky pro každého řidiče zjišťujete přes Job-ID.
Stejné jádro
Desktopový program a API počítají se stejným kódem. Pro stejný soubor a stejný pohled poskytuje API stejné výsledky jako program, jako data.
Dva pohledy
Každá odpověď obsahuje jeden ze dvou seznamů porušení. Přednastavený je přísný pohled, který odvozuje každé zjištění z textu nařízení a uvádí k němu příslušný článek. Podle práva EU si místo něj můžete vyžádat referenční pohled, který je kalibrován na výsledek zavedeného softwaru. Podle švýcarských předpisů ARV 1 a ARV 2 existuje pouze přísný pohled. Samostatný endpoint poskytuje katalog pravidel s jejich odkazy na ustanovení.
Zprávy
Zpráva z desktopového programu je k dispozici i přes API, jako HTML nebo jako tabulky CSV v archivu Zip. K tomu soupis zdrojů, který zaznamenává, který nahraný soubor pokrývá který den.
Pravost
Podpisy a certifikáty karty řidiče nebo stažení z celku vozidla lze ověřit přes API. Odpověď říká, co bylo ověřeno. Podpisy první generace karet tato verze zatím neověřuje, což není známkou manipulace.
Celek vozidla
Načíst lze i soubor stažený z vozidla. Vidíte, které karty byly v daném období vloženy a kteří řidiči s nimi jeli.
Generace
Čtou se karty řidičů generace 1 i generace 2 včetně verze 2. Soubory z celků vozidel čte API pouze ve formátech generace 2.
OpenAPI
Rozhraní je popsáno jako specifikace OpenAPI 3.1, kterou Container sám vydává. Dokumentace na docs.scernetta.com se z ní vytváří.
Jak se počítají řidiči
Každá karta řidiče, kterou během doby platnosti licence vyhodnotíte, se počítá jednou jako řidič, bez ohledu na to, jak často ji vyhodnocujete. Pokud řidič dostane obnovenou kartu nebo náhradní kartu, zůstává týmž řidičem. Pokud dostane kartu z jiné země, počítá se jako nový řidič. Své řidičské místo si řidič ponechává až do konce doby platnosti, i když váš podnik předtím opustí. Počítá se za všechny vaše instalace dohromady, včetně testovací instalace. Řidičské místo neobsazují ukázková karta z našich webových stránek, ověření pravosti a soubory z celků vozidel.
Licence
API se licencuje podle počtu řidičů a účtuje se ročně. Zda je licenční soubor pravý, ověřuje Container sám podle digitálního podpisu souboru, k tomu nepotřebuje spojení s námi. Když je řidič v době platnosti vyhodnocen poprvé, požádá Container náš licenční server o řidičské místo pro tohoto řidiče. Když placená licence vyprší, počítá Container ještě 14 dní dál, aby se vyhodnocení nezastavilo, pokud prodloužení přijde o několik dní později. Cenu sdělíme na vyžádání, protože závisí na velikosti vozového parku.
Bez spojení s licenčním serverem
Řidiče, kteří již mají řidičské místo, vyhodnocuje Container dál i bez spojení s naším licenčním serverem, a to 30 dní od posledního spojení, se zkušební licencí 14 dní. Pro nové řidiče má placená licence rezervu pro případ, že náš licenční server není dostupný déle než jednu minutu. Rezerva činí desetinu řidičských míst, nejméně však 2 místa na dobu platnosti, při 30 místech tedy 3. K tomu potřebuje Container svou složku na serveru. Tyto řidiče dodatečně nahlásí, jakmile bude licenční server opět dostupný. Zkušební licence nemá žádnou rezervu.
Co opouští server
Soubory karet se zpracovávají On-Prem, tedy ve vaší síti, a nikdy se k nám nepřenášejí. Kód řidiče vypočítá Container na vašem serveru z karty řidiče a vašeho tajného klíče, který nikdy nedostaneme. Z kódu nedokážeme vyčíst, kdo je řidič. S vaším klíčem lze však kód opět přiřadit řidiči, proto kód řidiče podle GDPR patří k osobním údajům. Posledních 20 zpráv, které Container od svého spuštění odeslal na náš licenční server, si můžete u Containeru vyžádat a přečíst v podobě, jakou měly před zašifrováním.
Dokumentace rozhraní je na docs.scernetta.com a vytváří se ze souboru OpenAPI. Začíná průvodcem ke spuštění, licenci a zpracování chyb a popisuje každý endpoint s jeho parametry.K dokumentaci
Pokud chcete API nasadit, napište nám, které systémy chcete připojit a o kolik řidičů nebo vozidel jde. Poté se ozveme s přístupem.