Ugyanaz az elemzés On-Prem konténerként a hálózatában
Az API ugyanaz az elemzőmag, mint az asztali programban, konténerimage-ként csomagolva, amelyet On-Prem üzemeltet, azaz egy saját szerveren vagy a fürtjében. A rendszerei a kártyafájlokat HTTP-n keresztül küldik a konténernek, és az elemzést JSON formátumban kapják vissza. A konténer a kártyafájlokat csak a memóriában tartja. Nem menti őket lemezre, és nem írja őket naplófájlba. A kártyafájlokat és az eredményeket nem küldi el nekünk. Ahhoz, hogy meg tudjuk számolni, hány járművezetőt elemez a licencével, a konténer csatlakozik a license.scernetta.com címen elérhető licencszerverünkhöz, mégpedig az indítás után, körülbelül 6 óránként, valamint új járművezető esetén. A licencszerver ekkor megkapja az Ön licencfájljának szövegét a cégnevével, a konténer verziószámát, néhány technikai ellenőrző értéket és minden új járművezetőhöz egy járművezetői kódot. A járművezetői kódot a konténer az Ön szerverén számítja ki a járművezetői kártyából és az Ön titkos kulcsából.
Kinek szánjuk
Azoknak a flottáknak szánjuk, amelyek saját TMS-sel vagy ERP-vel rendelkeznek, és ott szeretnék tovább feldolgozni az elemzést. Azok a telematikai szolgáltatók, amelyek amúgy is gyűjtik a kártyaadatokat, ezzel közvetlenül ellenőriztethetik őket, a sok ügyfél járművezetői kártyáit elemző szolgáltatók pedig megspórolják az asztali programon át vezető kerülőutat.
Hogyan zajlik
Tőlünk kap egy licencfájlt. Az első indítás előtt egyszer, a konténerimage egyik parancsával létrehoz egy titkos kulcsot, amelyből a konténer a járművezetői kódokat számítja ki. Ezt a kulcsot használja az összes telepítésén, és őrizzen meg róla egy másolatot. A konténer a hálózatában lévő egyik szerveren fut, és ott saját mappára van szüksége, amelyben nyilvántartja, mely járművezetőknek van már járművezetői helyük. A szervernek el kell tudnia érni a license.scernetta.com címet, közvetlenül vagy az Ön HTTP-proxyján keresztül. A rendszerei egy API-kulccsal jelentkeznek be, és HTTP-n keresztül adják át a .ddd-fájlokat, egyenként vagy járművezetőnként kötegelve, a konténer pedig pontosan úgy fűzi össze őket, ahogy az asztali program teszi. Vissza egy JSON érkezik a műszakokkal, a kiválasztott nézet jogsértéseivel, az előrejelzésekkel és a nem értékelhető időszakokkal, amelyet közvetlenül tovább tud feldolgozni.
Egy egész flotta egyszerre történő feldolgozásához kötegelt végpont áll rendelkezésre. Az összes fájlt egyetlen kérésben tölti fel, a konténer maga rendeli hozzá őket a járművezetőkhöz, és a háttérben számol. A kérésben szereplő minden új járművezetőnek a konténer már a beküldéskor lefoglal egy járművezetői helyet. Ha a szabad járművezetői helyek nem elegendők az összes új járművezetőhöz, a teljes kérést elutasítja, és egyetlen helyet sem foglal le. A folyamat állását és a járművezetőnkénti eredményeket egy feladatazonosítón keresztül kérdezi le.
Ugyanaz a mag
Az asztali program és az API ugyanazzal a kóddal számol. Ugyanarra a fájlra és ugyanarra a nézetre az API ugyanazokat az eredményeket adja, mint a program, adatként.
Két nézet
Minden válasz a két jogsértéslista egyikét tartalmazza. Alapértelmezés szerint a szigorú nézet érvényes, amely minden megállapítást a rendelet szövegéből vezet le, és megnevezi hozzá a cikket. EU-jog szerint helyette lekérheti a referencianézetet, amely a bevett szoftverek eredményéhez van kalibrálva. A svájci ARV 1 és ARV 2 szabályai szerint csak a szigorú nézet áll rendelkezésre. Egy külön végpont adja ki a szabályok katalógusát a hivatkozási helyeikkel.
Jelentések
Az asztali program jelentése az API-n keresztül is elérhető, HTML-ként vagy CSV-táblázatokként egy zip-ben. Mellé egy forrásjegyzék is tartozik, amely rögzíti, melyik feltöltött fájl melyik napot fedi le.
Hitelesség
Egy járművezetői kártya vagy egy járműegység-letöltés aláírásai és tanúsítványai az API-n keresztül ellenőrizhetők. A válasz megmondja, mit sikerült igazolni. Az első kártyageneráció aláírásait ez a verzió még nem ellenőrzi, ez nem utal manipulációra.
Járműegység
A jármű letöltési fájlja is beolvasható. Látja, mely kártyák voltak behelyezve egy adott időszakban, és mely járművezetők vezettek velük.
Generációk
A rendszer beolvassa az 1. generációs, valamint a 2. generációs járművezetői kártyákat, a 2-es verziót is beleértve. A járműegységek fájljait az API csak a 2. generáció formátumaiban olvassa be.
OpenAPI
A felületet OpenAPI 3.1 specifikáció írja le, amelyet maga a konténer szolgáltat. A docs.scernetta.com alatti dokumentáció ebből jön létre.
Hogyan számoljuk a járművezetőket
Minden járművezetői kártya, amelyet licencének futamideje alatt elemez, egyszer számít járművezetőnek, függetlenül attól, hányszor elemzi. Ha egy járművezető megújított kártyát vagy pótkártyát kap, ugyanaz a járművezető marad. Ha egy másik országból kap kártyát, új járművezetőnek számít. A járművezetői helyét a járművezető a futamidő végéig megtartja, akkor is, ha előtte elhagyja a vállalkozását. A számlálás az összes telepítését együttesen veszi figyelembe, egy tesztelési célú telepítést is beleértve. Nem foglal járművezetői helyet a weboldalunkon található mintakártya, a hitelességi ellenőrzés és a járműegységekből származó fájlok.
Licenc
Az API licencelése a járművezetők száma szerint történik, és évente számlázunk. Azt, hogy a licencfájl valódi-e, a konténer maga ellenőrzi a digitális aláírása alapján, ehhez nincs szüksége kapcsolatra velünk. Ha egy járművezetőt a futamidő alatt először elemez, a konténer járművezetői helyet kér neki a licencszerverünktől. Ha egy fizetős licenc lejár, a konténer még 14 napig tovább számol, hogy az elemzés ne álljon le, ha a meghosszabbítás néhány nappal később érkezik. Az árat kérésre adjuk meg, mert a flotta méretétől függ.
A licencszerverrel való kapcsolat nélkül
Azokat a járművezetőket, akiknek már van járművezetői helyük, a konténer a licencszerverünkkel való kapcsolat nélkül is tovább elemzi, az utolsó kapcsolattól számított 30 napig, próbalicenc esetén 14 napig. Új járművezetők számára a fizetős licenc tartalékot tartalmaz arra az esetre, ha a licencszerverünk egy percnél hosszabb ideig nem érhető el. A tartalék a járművezetői helyek egytizede, de futamidőnként legalább 2 hely, 30 helynél tehát 3. Ehhez a konténernek szüksége van a saját mappájára a szerveren. Ezeket a járművezetőket utólag jelenti, amint a licencszerver ismét elérhető. A próbalicencnek nincs tartaléka.
Mi hagyja el a szervert
A kártyafájlok feldolgozása On-Prem, azaz a hálózatában történik, és soha nem kerülnek hozzánk továbbításra. A járművezetői kódot a konténer az Ön szerverén számítja ki a járművezetői kártyából és az Ön titkos kulcsából, amelyet mi soha nem kapunk meg. A kódból nem tudjuk megállapítani, ki a járművezető. Az Ön kulcsával azonban a kód ismét hozzárendelhető egy járművezetőhöz, ezért a GDPR szerint személyes adatnak minősül. Az utolsó 20 üzenetet, amelyet a konténer az indítása óta a licencszerverünknek küldött, lekérheti a konténertől és elolvashatja, abban a formában, ahogyan a titkosítás előtt kinéztek.
A felület dokumentációja a docs.scernetta.com alatt található, és az OpenAPI-fájlból jön létre. Egy útmutatóval kezdődik az indításról, a licencről és a hibakezelésről, majd minden végpontot leír a paramétereivel.A dokumentációhoz
Ha használni szeretné az API-t, írja meg, mely rendszereket kívánja csatlakoztatni, és hány járművezetőről vagy járműről van szó. Ekkor egy hozzáféréssel jelentkezünk.