Aceeași analiză sub formă de Container On-Prem în rețeaua dumneavoastră
API-ul este același nucleu de analiză ca în programul desktop, împachetat ca imagine de Container pe care o rulați On-Prem, adică pe un server propriu sau în clusterul dumneavoastră. Sistemele dumneavoastră trimit fișierele de cartelă către Container prin HTTP și primesc analiza înapoi ca JSON. Containerul păstrează fișierele de cartelă numai în memoria de lucru. Nu le salvează pe disc și nu le scrie în niciun fișier jurnal. Nu ne trimite nici fișierele de cartelă, nici rezultatele. Pentru ca noi să putem număra câți conducători auto analizați cu licența dumneavoastră, se conectează la serverul nostru de licențe de la license.scernetta.com, și anume după pornire, aproximativ la fiecare 6 ore și la apariția unui conducător auto nou. Serverul de licențe primește în acest proces textul fișierului dumneavoastră de licență cu numele firmei dumneavoastră, numărul de versiune al Containerului, câteva valori tehnice de verificare și, pentru fiecare conducător auto nou, un cod de conducător auto. Codul de conducător auto îl calculează Containerul pe serverul dumneavoastră, din cartela de conducător auto și din cheia dumneavoastră secretă.
Pentru cine este gândit
Este gândit pentru flote cu TMS sau ERP propriu, care vor să prelucreze analiza mai departe acolo. Furnizorii de telematică, care oricum strâng deja date de pe cartele, le pot pune direct la verificare, iar prestatorii de servicii care analizează cartele de conducător auto pentru mulți clienți scapă de ocolul printr-un program desktop.
Cum decurge
Primiți de la noi un fișier de licență. Înainte de prima pornire generați o singură dată, cu o comandă din imaginea de Container, o cheie secretă, din care Containerul calculează codurile de conducător auto. Folosiți această cheie pe toate instalările și păstrați o copie a ei. Containerul rulează pe un server din rețeaua dumneavoastră și are nevoie acolo de un folder propriu, în care reține ce conducători auto au deja un loc de conducător auto. Serverul trebuie să poată accesa license.scernetta.com, direct sau prin proxy-ul dumneavoastră HTTP. Sistemele dumneavoastră se autentifică cu o cheie API și transmit fișierele .ddd prin HTTP, individual sau grupate pe conducător auto, iar Containerul le combină exact așa cum o face programul desktop. Înapoi vine un JSON cu turele, încălcările din perspectiva aleasă, previziunile și intervalele neevaluabile, pe care îl puteți prelucra mai departe direct.
Pentru o flotă întreagă deodată există un endpoint batch. Încărcați toate fișierele într-o singură cerere, Containerul le atribuie el însuși conducătorilor auto și calculează în fundal. Pentru fiecare conducător auto nou din cerere, Containerul ocupă un loc de conducător auto încă de la trimiterea cererii. Dacă locurile de conducător auto libere nu ajung pentru toți conducătorii auto noi, respinge întreaga cerere și nu ocupă niciun loc de conducător auto. Progresul și rezultatele pe fiecare conducător auto le interogați printr-un ID de sarcină.
Același nucleu
Programul desktop și API-ul calculează cu același cod. Pentru același fișier și aceeași perspectivă, API-ul livrează aceleași rezultate ca programul, sub formă de date.
Două perspective
Fiecare răspuns conține una dintre cele două liste de încălcări. Implicit este perspectiva strictă, care deduce fiecare constatare din textul regulamentului și indică articolul aferent. Conform dreptului UE puteți solicita în schimb perspectiva de referință, care este calibrată după rezultatul software-ului consacrat. Conform regulilor elvețiene ARV 1 și ARV 2 există numai perspectiva strictă. Un endpoint separat livrează catalogul regulilor, cu trimiterile aferente.
Rapoarte
Raportul din programul desktop vine și prin API, ca HTML sau ca tabele CSV într-un fișier zip. La acestea se adaugă un manifest de surse, care reține ce fișier încărcat acoperă ce zi.
Autenticitate
Semnăturile și certificatele unei cartele de conducător auto sau ale unei descărcări de unitate montată pe vehicul pot fi verificate prin API. Răspunsul spune ce a fost verificat. Semnăturile primei generații de cartele nu sunt verificate încă de această versiune, iar acest lucru nu este un indiciu de manipulare.
Unitatea montată pe vehicul
Poate fi citit și fișierul de descărcare al vehiculului. Vedeți ce cartele au fost introduse într-un interval și ce conducători auto au condus cu ele.
Generații
Se citesc cartele de conducător auto din generația 1, precum și din generația 2, inclusiv versiunea 2. Fișierele unităților montate pe vehicul sunt citite de API numai în formatele generației 2.
OpenAPI
Interfața este descrisă ca specificație OpenAPI 3.1, pe care Containerul o livrează el însuși. Documentația de la docs.scernetta.com este generată din ea.
Cum sunt numărați conducătorii auto
Fiecare cartelă de conducător auto pe care o analizați în perioada de valabilitate a licenței dumneavoastră contează o singură dată ca un conducător auto, indiferent de câte ori o analizați. Dacă un conducător auto primește o cartelă reînnoită sau o cartelă de înlocuire, el rămâne același conducător auto. Dacă primește o cartelă dintr-o altă țară, contează ca un conducător auto nou. Un conducător auto își păstrează locul de conducător auto până la sfârșitul perioadei de valabilitate, chiar dacă părăsește firma dumneavoastră înainte. Se numără pentru toate instalările dumneavoastră împreună, inclusiv pentru o instalare de test. Nu ocupă niciun loc de conducător auto cartela de exemplu de pe site-ul nostru, verificarea autenticității și fișierele din unitățile montate pe vehicul.
Licență
API-ul se licențiază după numărul de conducători auto și se facturează anual. Containerul verifică el însuși, pe baza semnăturii digitale, dacă fișierul de licență este autentic și nu are nevoie pentru aceasta de o conexiune la noi. Când un conducător auto este analizat pentru prima dată în perioada de valabilitate, Containerul solicită serverului nostru de licențe un loc de conducător auto pentru el. Dacă o licență plătită expiră, Containerul continuă să calculeze încă 14 zile, pentru ca analiza să nu se oprească atunci când reînnoirea vine cu câteva zile mai târziu. Prețul îl comunicăm la cerere, fiindcă depinde de mărimea flotei.
Fără conexiune la serverul de licențe
Pe conducătorii auto care au deja un loc de conducător auto, Containerul îi analizează în continuare și fără conexiune la serverul nostru de licențe, timp de 30 de zile de la ultima conexiune, iar cu o licență de probă 14 zile. Pentru conducătorii auto noi, o licență plătită are o rezervă, pentru cazul în care serverul nostru de licențe nu poate fi accesat mai mult de un minut. Rezerva este o zecime din locurile de conducător auto, dar cel puțin 2 locuri pe perioadă de valabilitate, deci 3 la 30 de locuri. Pentru aceasta, Containerul are nevoie de folderul său de pe server. Pe acești conducători auto îi raportează ulterior, de îndată ce serverul de licențe poate fi accesat din nou. O licență de probă nu are rezervă.
Ce părăsește serverul
Fișierele de cartelă sunt prelucrate On-Prem, adică în rețeaua dumneavoastră, și nu ne sunt transmise niciodată. Codul de conducător auto îl calculează Containerul pe serverul dumneavoastră, din cartela de conducător auto și din cheia dumneavoastră secretă, pe care noi nu o primim niciodată. Din cod nu putem afla cine este conducătorul auto. Cu cheia dumneavoastră, codul poate fi însă atribuit din nou unui conducător auto, de aceea, conform RGPD, el face parte din datele cu caracter personal. Ultimele 20 de mesaje pe care Containerul le-a trimis serverului nostru de licențe de la pornire le puteți prelua de la Container și citi, așa cum arătau înainte de criptare.
Documentația interfeței se află la docs.scernetta.com și este generată din fișierul OpenAPI. Începe cu un ghid despre pornire, licență și tratarea erorilor și descrie fiecare endpoint cu parametrii săi.Către documentație
Dacă vreți să folosiți API-ul, scrieți-ne ce sisteme doriți să conectați și despre câți conducători auto sau câte vehicule este vorba. Revenim apoi cu un acces.