Sama analüüs On-Prem konteinerina teie võrgus
API on sama analüüsituum nagu töölauaprogrammis, pakendatuna konteineritõmmiseks, mida käitate On-Prem, see tähendab oma serveris või oma klastris. Teie süsteemid saadavad kaardifailid HTTP kaudu konteinerisse ja saavad analüüsi tagasi JSON-ina. Konteiner hoiab kaardifaile ainult muutmälus. See ei salvesta neid kõvakettale ega kirjuta neid ühtegi logifaili. Kaardifaile ja tulemusi see meile ei saada. Et saaksime loendada, mitut juhti te oma litsentsiga analüüsite, ühendub see meie litsentsiserveriga aadressil license.scernetta.com, nimelt pärast käivitamist, umbes iga 6 tunni järel ja siis, kui lisandub uus juht. Litsentsiserver saab sealjuures teie litsentsifaili teksti koos teie ettevõtte nimega, konteineri versiooninumbri, mõned tehnilised kontrollväärtused ja iga uue juhi kohta juhikoodi. Juhikoodi arvutab konteiner teie serveris juhikaardist ja teie salajasest võtmest.
Kellele see on mõeldud
See on mõeldud autoparkidele, kellel on oma TMS või ERP ja kes soovivad analüüsi seal edasi töödelda. Telemaatikapakkujad, kes kaardiandmeid niikuinii juba koguvad, saavad need sellega otse kontrollida lasta, ja teenusepakkujad, kes analüüsivad juhikaarte paljude klientide jaoks, säästavad end töölauaprogrammi kaudu tehtavast ümberteest.
Kuidas see toimub
Saate meilt litsentsifaili. Enne esimest käivitamist loote konteineritõmmises oleva käsuga ühe korra salajase võtme, millest konteiner arvutab juhikoodid. Kasutage seda võtit kõigis paigaldustes ja hoidke sellest koopiat alles. Konteiner töötab serveris teie võrgus ja vajab seal oma kausta, kuhu see märgib, millistel juhtidel on juba juhikoht. Server peab saama ühenduse aadressiga license.scernetta.com, otse või teie HTTP-puhverserveri kaudu. Teie süsteemid logivad sisse API-võtmega ja annavad .ddd-failid HTTP kaudu üle, ükshaaval või juhi kaupa koondatuna, ja konteiner ühendab need täpselt nii, nagu teeb seda töölauaprogramm. Tagasi tuleb JSON, mis sisaldab vahetusi, valitud vaate rikkumisi, prognoose ja ajavahemikke, mida ei saa hinnata, ning mille saate otse edasi töödelda.
Terve autopargi jaoks korraga on olemas partii-lõpp-punkt. Laadite kõik failid ühe päringuga üles, konteiner seob need ise juhtidega ja arvutab taustal. Iga päringus oleva uue juhi jaoks hõivab konteiner juhikoha juba päringu esitamisel. Kui vabadest juhikohtadest ei piisa kõigi uute juhtide jaoks, lükkab see kogu päringu tagasi ega hõiva ühtki kohta. Edenemist ja iga juhi tulemusi pärite töö-ID kaudu.
Sama tuum
Töölauaprogramm ja API arvutavad sama koodiga. Sama faili ja sama vaate puhul annab API samad tulemused nagu programm, andmetena.
Kaks vaadet
Iga vastus sisaldab üht kahest rikkumiste loendist. Vaikimisi on valitud range vaade, mis tuletab iga leiu määruse tekstist ja nimetab juurde artikli. EL-i õiguse järgi saate selle asemel pärida viitevaate, mis on kalibreeritud väljakujunenud tarkvara tulemuse järgi. Šveitsi reeglite ARV 1 ja ARV 2 järgi on ainult range vaade. Eraldi lõpp-punkt annab reeglite kataloogi koos nende viidetega.
Aruanded
Töölauaprogrammi aruanne tuleb ka API kaudu, HTML-ina või CSV-tabelitena zip-failis. Lisaks allikamanifest, mis talletab, milline üleslaaditud fail millist päeva tõendab.
Ehtsus
Juhikaardi või sõidukiseadme allalaadimise allkirju ja sertifikaate saab API kaudu kontrollida. Vastus ütleb, mida kinnitati. Esimese põlvkonna kaardi allkirju see versioon veel ei kontrolli, see ei ole märk võltsimisest.
Sõidukiseade
Ka sõiduki allalaadimisfaili saab sisse lugeda. Näete, millised kaardid olid teatud ajavahemikul sisestatud ja millised juhid nendega sõitsid.
Põlvkonnad
Loetakse 1. põlvkonna ning 2. põlvkonna juhikaarte, sealhulgas versiooni 2. Sõidukiseadmete faile loeb API ainult 2. põlvkonna vormingutes.
OpenAPI
Liides on kirjeldatud OpenAPI 3.1 spetsifikatsioonina, mille konteiner ise väljastab. Dokumentatsioon aadressil docs.scernetta.com luuakse sellest.
Kuidas juhte loendatakse
Iga juhikaart, mida analüüsite oma litsentsi kehtivusaja jooksul, läheb juhina arvesse üks kord, olenemata sellest, kui sageli te seda analüüsite. Kui juht saab uuendatud kaardi või asenduskaardi, jääb ta samaks juhiks. Kui ta saab kaardi teisest riigist, loetakse ta uueks juhiks. Oma juhikoha säilitab juht kehtivusaja lõpuni, ka siis, kui ta lahkub teie ettevõttest varem. Loendatakse kõigi teie paigalduste peale kokku, kaasa arvatud testpaigaldus. Juhikohta ei hõiva meie veebisaidi näidiskaart, ehtsuse kontroll ega sõidukiseadmete failid.
Litsents
API litsentsitakse juhtide arvu järgi ja arveldatakse kord aastas. Kas litsentsifail on ehtne, kontrollib konteiner ise selle digitaalallkirja järgi, selleks ei vaja see ühendust meiega. Kui juhti analüüsitakse kehtivusaja jooksul esimest korda, küsib konteiner meie litsentsiserverilt talle juhikoha. Kui tasuline litsents lõpeb, arvutab konteiner veel 14 päeva edasi, et analüüs ei seiskuks, kui pikendamine tuleb paar päeva hiljem. Hinna nimetame soovi korral, sest see sõltub autopargi suurusest.
Ilma ühenduseta litsentsiserveriga
Juhte, kellel on juba juhikoht, analüüsib konteiner edasi ka ilma ühenduseta meie litsentsiserveriga, 30 päeva jooksul alates viimasest ühendusest, proovilitsentsiga 14 päeva. Uute juhtide jaoks on tasulisel litsentsil reserv juhuks, kui meie litsentsiserver ei ole kauem kui ühe minuti kättesaadav. Reserv on kümnendik juhikohtadest, kuid iga kehtivusaja jooksul vähemalt 2 kohta, 30 koha puhul seega 3. Selleks vajab konteiner serveris oma kausta. Need juhid teatab see tagantjärele, niipea kui litsentsiserver on jälle kättesaadav. Proovilitsentsil reservi ei ole.
Mis serverist lahkub
Kaardifaile töödeldakse On-Prem, see tähendab teie võrgus, ja neid ei edastata meile kunagi. Juhikoodi arvutab konteiner teie serveris juhikaardist ja teie salajasest võtmest, mida me kunagi ei saa. Koodist ei saa me välja lugeda, kes on juht. Teie võtmega saab koodi aga uuesti juhiga seostada, seepärast kuulub juhikood IKÜMi järgi isikuandmete hulka. Viimased 20 sõnumit, mille konteiner on pärast käivitamist meie litsentsiserverile saatnud, saate konteinerist pärida ja lugeda sellisena, nagu need olid enne krüpteerimist.
Liidese dokumentatsioon asub aadressil docs.scernetta.com ja luuakse OpenAPI-failist. See algab juhendiga alustamise, litsentsi ja vigade käsitlemise kohta ning kirjeldab iga lõpp-punkti koos selle parameetritega.Dokumentatsiooni juurde
Kui soovite API-t kasutada, kirjutage meile, milliseid süsteeme soovite ühendada ja kui mitmest juhist või sõidukist on jutt. Seejärel võtame teiega ühendust ja anname juurdepääsu.