Ta sama analiza jako Container On-Prem w Państwa sieci
API to ten sam rdzeń analityczny co w programie desktopowym, zapakowany jako obraz Container, który uruchamiają Państwo On-Prem, czyli na własnym serwerze lub w swoim klastrze. Państwa systemy wysyłają pliki kart przez HTTP do Containera i otrzymują analizę w formacie JSON. Container przechowuje pliki kart wyłącznie w pamięci operacyjnej. Nie zapisuje ich na dysku i nie umieszcza ich w żadnym pliku logu. Plików kart ani wyników nie wysyła do nas. Abyśmy mogli policzyć, ilu kierowców analizują Państwo w ramach swojej licencji, łączy się on z naszym serwerem licencyjnym pod adresem license.scernetta.com po uruchomieniu, mniej więcej co 6 godzin oraz gdy pojawia się nowy kierowca. Serwer licencyjny otrzymuje przy tym treść Państwa pliku licencyjnego z nazwą Państwa firmy, numer wersji Containera, kilka technicznych wartości kontrolnych oraz dla każdego nowego kierowcy kod kierowcy. Kod kierowcy Container oblicza na Państwa serwerze z karty kierowcy i Państwa tajnego klucza.
Dla kogo to jest przeznaczone
Jest to przeznaczone dla flot z własnym systemem TMS lub ERP, które chcą tam dalej przetwarzać analizę. Dostawcy telematyki, którzy i tak zbierają już dane z kart, mogą zlecić ich bezpośrednie sprawdzenie, a usługodawcy analizujący karty kierowców dla wielu klientów oszczędzają sobie okrężnej drogi przez program desktopowy.
Jak to przebiega
Otrzymują Państwo od nas plik licencyjny. Przed pierwszym uruchomieniem tworzą Państwo jednorazowo, za pomocą polecenia z obrazu Container, tajny klucz, z którego Container oblicza kody kierowców. Prosimy używać tego klucza we wszystkich instalacjach i przechowywać jego kopię. Container działa na serwerze w Państwa sieci i potrzebuje tam własnego folderu, w którym zapisuje, którzy kierowcy mają już miejsce kierowcy. Serwer musi mieć dostęp do license.scernetta.com, bezpośrednio lub przez Państwa serwer proxy HTTP. Państwa systemy uwierzytelniają się kluczem API i przekazują pliki .ddd przez HTTP, pojedynczo lub w pakietach na kierowcę, a Container łączy je dokładnie tak, jak robi to program desktopowy. W zamian przychodzi JSON ze zmianami, naruszeniami w wybranym widoku, prognozami i okresami niemożliwymi do oceny, który mogą Państwo od razu dalej przetwarzać.
Dla całej floty naraz dostępny jest punkt końcowy wsadowy (batch). W jednym żądaniu przesyłają Państwo wszystkie pliki, Container sam przypisuje je do kierowców i liczy w tle. Dla każdego nowego kierowcy w żądaniu Container zajmuje miejsce kierowcy już w chwili złożenia żądania. Jeśli wolnych miejsc kierowców nie wystarcza dla wszystkich nowych kierowców, odrzuca całe żądanie i nie zajmuje żadnego miejsca. Postęp i wyniki dla poszczególnych kierowców pobierają Państwo za pomocą identyfikatora zadania (Job-ID).
Ten sam rdzeń
Program desktopowy i API liczą na tym samym kodzie. Dla tego samego pliku i tego samego widoku API dostarcza te same wyniki co program, w postaci danych.
Dwa widoki
Każda odpowiedź zawiera jedną z dwóch list naruszeń. Domyślnie ustawiony jest widok ścisły, który wywodzi każde ustalenie z treści rozporządzenia i podaje odpowiedni artykuł. Według prawa UE mogą Państwo zamiast niego pobrać widok odniesienia, skalibrowany względem wyników uznanego oprogramowania. Według szwajcarskich przepisów ARV 1 i ARV 2 dostępny jest tylko widok ścisły. Osobny punkt końcowy dostarcza katalog reguł wraz z podstawami prawnymi.
Raporty
Raport z programu desktopowego dostępny jest również przez API, jako HTML lub jako tabele CSV w archiwum ZIP. Do tego manifest źródeł, który zapisuje, który przesłany plik potwierdza który dzień.
Autentyczność
Podpisy i certyfikaty karty kierowcy lub pobrania z jednostki pojazdowej można sprawdzić przez API. Odpowiedź mówi, co zostało zweryfikowane. Podpisów pierwszej generacji kart ta wersja jeszcze nie sprawdza, co nie jest przesłanką manipulacji.
Jednostka pojazdowa
Można również wczytać plik pobrania z pojazdu. Widzą Państwo, które karty były włożone w danym okresie i którzy kierowcy nimi jeździli.
Generacje
Odczytywane są karty kierowców generacji 1 oraz generacji 2, w tym wersji 2. Pliki z jednostek pojazdowych API odczytuje tylko w formatach generacji 2.
OpenAPI
Interfejs jest opisany jako specyfikacja OpenAPI 3.1, którą Container sam udostępnia. Dokumentacja pod adresem docs.scernetta.com jest z niej generowana.
Jak liczeni są kierowcy
Każda karta kierowcy, którą analizują Państwo w okresie obowiązywania licencji, liczy się raz jako kierowca, niezależnie od tego, jak często ją Państwo analizują. Gdy kierowca otrzyma odnowioną kartę lub kartę zastępczą, pozostaje tym samym kierowcą. Gdy otrzyma kartę wydaną w innym państwie, liczy się jako nowy kierowca. Kierowca zachowuje swoje miejsce kierowcy do końca okresu obowiązywania, nawet jeśli wcześniej odejdzie z Państwa przedsiębiorstwa. Liczone są łącznie wszystkie Państwa instalacje, również instalacja testowa. Miejsca kierowcy nie zajmują przykładowa karta z naszej witryny, sprawdzanie autentyczności ani pliki z jednostek pojazdowych.
Licencja
API jest licencjonowane według liczby kierowców i rozliczane rocznie. Autentyczność pliku licencyjnego Container sprawdza sam na podstawie jego podpisu cyfrowego i nie potrzebuje do tego połączenia z nami. Gdy kierowca jest analizowany po raz pierwszy w okresie obowiązywania licencji, Container prosi nasz serwer licencyjny o miejsce kierowcy dla niego. Gdy płatna licencja wygaśnie, Container liczy jeszcze przez 14 dni, aby analiza nie została wstrzymana, jeśli przedłużenie nadejdzie kilka dni później. Cenę podajemy na życzenie, ponieważ zależy ona od wielkości floty.
Bez połączenia z serwerem licencyjnym
Kierowców, którzy mają już miejsce kierowcy, Container analizuje dalej także bez połączenia z naszym serwerem licencyjnym, przez 30 dni od ostatniego połączenia, a przy licencji próbnej przez 14 dni. Dla nowych kierowców płatna licencja ma rezerwę na wypadek, gdyby nasz serwer licencyjny był niedostępny dłużej niż minutę. Rezerwa wynosi jedną dziesiątą miejsc kierowców, ale co najmniej 2 miejsca na okres obowiązywania, czyli przy 30 miejscach 3. Do tego Container potrzebuje swojego folderu na serwerze. Tych kierowców zgłasza później, gdy tylko serwer licencyjny znów będzie dostępny. Licencja próbna nie ma rezerwy.
Co opuszcza serwer
Pliki kart są przetwarzane On-Prem, czyli w Państwa sieci, i nigdy nie są do nas przesyłane. Kod kierowcy Container oblicza na Państwa serwerze z karty kierowcy i Państwa tajnego klucza, którego nigdy nie otrzymujemy. Z kodu nie możemy odczytać, kim jest kierowca. Za pomocą Państwa klucza kod można jednak ponownie przypisać do kierowcy, dlatego w rozumieniu RODO stanowi on dane osobowe. Ostatnie 20 wiadomości, które Container od uruchomienia wysłał do naszego serwera licencyjnego, mogą Państwo pobrać z Containera i przeczytać w postaci sprzed zaszyfrowania.
Dokumentacja interfejsu znajduje się pod adresem docs.scernetta.com i jest generowana z pliku OpenAPI. Rozpoczyna się przewodnikiem po uruchomieniu, licencji i obsłudze błędów oraz opisuje każdy punkt końcowy wraz z jego parametrami.Przejdź do dokumentacji
Jeśli chcą Państwo wdrożyć API, prosimy napisać, które systemy chcą Państwo podłączyć i o ilu kierowców lub pojazdów chodzi. Odezwiemy się wówczas z dostępem.