Ta pati analizė kaip On-Prem Container jūsų tinkle
API yra tas pats analizės branduolys kaip darbalaukio programoje, supakuotas kaip Container atvaizdis, kurį naudojate On-Prem, t. y. savo pačių serveryje arba klasteryje. Jūsų sistemos siunčia kortelių failus per HTTP į Container ir gauna analizę JSON formatu. Container kortelių failus laiko tik darbinėje atmintyje. Jis neišsaugo jų diske ir nerašo jų į jokį žurnalo failą. Kortelių failų ir rezultatų jis mums nesiunčia. Kad galėtume suskaičiuoti, kiek vairuotojų analizuojate su savo licencija, jis jungiasi prie mūsų licencijų serverio adresu license.scernetta.com po paleidimo, maždaug kas 6 valandas ir atsiradus naujam vairuotojui. Tuo metu licencijų serveris gauna jūsų licencijos failo tekstą su jūsų įmonės pavadinimu, Container versijos numerį, kelias technines kontrolines reikšmes ir kiekvienam naujam vairuotojui po vieną vairuotojo kodą. Vairuotojo kodą Container apskaičiuoja jūsų serveryje iš vairuotojo kortelės ir jūsų slaptojo rakto.
Kam tai skirta
Tai skirta parkams su savo TMS ar ERP, kurie nori analizę toliau apdoroti ten. Telematikos tiekėjai, kurie kortelių duomenis vis tiek jau renka, gali juos taip patikrinti tiesiogiai, o paslaugų teikėjai, kurie analizuoja vairuotojų korteles daugeliui klientų, išvengia aplinkkelio per darbalaukio programą.
Kaip tai vyksta
Iš mūsų gaunate licencijos failą. Prieš pirmąjį paleidimą vieną kartą Container atvaizdyje esančia komanda sukuriate slaptąjį raktą, iš kurio Container apskaičiuoja vairuotojų kodus. Naudokite šį raktą visuose įdiegimuose ir pasilikite jo kopiją. Container veikia serveryje jūsų tinkle, ir tame serveryje jam reikia atskiro aplanko, kuriame jis fiksuoja, kurie vairuotojai jau turi vairuotojo vietą. Serveris turi galėti pasiekti license.scernetta.com tiesiogiai arba per jūsų HTTP tarpinį serverį. Jūsų sistemos prisijungia su API raktu ir perduoda .ddd failus per HTTP, po vieną arba sugrupuotus pagal vairuotoją, o Container juos sujungia lygiai taip, kaip tai daro darbalaukio programa. Atgal gaunate JSON su pamainomis, pasirinkto rodinio pažeidimais, prognozėmis ir nevertinamais laikotarpiais, kurį galite iškart toliau apdoroti.
Visam parkui iš karto yra paketinis galinis taškas. Visus failus įkeliate viena užklausa, Container pats priskiria juos vairuotojams ir skaičiuoja fone. Kiekvienam naujam užklausos vairuotojui Container vairuotojo vietą užima jau pateikiant užklausą. Jei laisvų vairuotojo vietų nepakanka visiems naujiems vairuotojams, jis atmeta visą užklausą ir neužima nė vienos vietos. Eigą ir kiekvieno vairuotojo rezultatus užklausiate pagal užduoties ID.
Tas pats branduolys
Darbalaukio programa ir API skaičiuoja tuo pačiu kodu. Tam pačiam failui ir tam pačiam rodiniui API pateikia tuos pačius rezultatus kaip programa, duomenų pavidalu.
Du rodiniai
Kiekviename atsakyme yra vienas iš dviejų pažeidimų sąrašų. Numatytasis yra griežtasis rodinys, kuris kiekvieną išvadą kildina iš teisės akto teksto ir nurodo atitinkamą straipsnį. Pagal ES teisę vietoj jo galite užklausti atskaitos rodinio, kuris sukalibruotas pagal įsitvirtinusios programinės įrangos rezultatus. Pagal Šveicarijos taisykles ARV 1 ir ARV 2 yra tik griežtasis rodinys. Atskiras galinis taškas pateikia taisyklių katalogą su jų nuorodomis.
Ataskaitos
Darbalaukio programos ataskaita pasiekiama ir per API, kaip HTML arba kaip CSV lentelės Zip archyve. Kartu pateikiamas šaltinių sąrašas, kuriame nurodoma, kuris įkeltas failas pagrindžia kurią dieną.
Autentiškumas
Vairuotojo kortelės ar transporto priemonės bloko atsisiuntimo parašus ir sertifikatus galima patikrinti per API. Atsakyme nurodoma, kas buvo patvirtinta. Pirmosios kortelių kartos parašų ši versija dar netikrina, ir tai nėra klastojimo požymis.
Transporto priemonės blokas
Galima nuskaityti ir transporto priemonės atsisiuntimo failą. Matote, kurios kortelės tam tikru laikotarpiu buvo įkištos ir kurie vairuotojai su jomis vairavo.
Kartos
Nuskaitomos 1 kartos ir 2 kartos, įskaitant 2 versiją, vairuotojų kortelės. Transporto priemonių blokų failus API nuskaito tik 2 kartos formatais.
OpenAPI
Sąsaja aprašyta kaip OpenAPI 3.1 specifikacija, kurią pateikia pats Container. Dokumentacija adresu docs.scernetta.com kuriama iš jos.
Kaip skaičiuojami vairuotojai
Kiekviena vairuotojo kortelė, kurią analizuojate per savo licencijos galiojimo laikotarpį, skaičiuojama kaip vienas vairuotojas, nesvarbu, kiek kartų ją analizuojate. Jei vairuotojas gauna atnaujintą arba pakaitinę kortelę, jis lieka tas pats vairuotojas. Jei jis gauna kitos šalies kortelę, jis skaičiuojamas kaip naujas vairuotojas. Savo vairuotojo vietą vairuotojas išlaiko iki galiojimo laikotarpio pabaigos, net jei anksčiau išeina iš jūsų įmonės. Vairuotojai skaičiuojami visuose jūsų įdiegimuose kartu, įskaitant ir testavimui skirtą įdiegimą. Vairuotojo vietos neužima pavyzdinė kortelė iš mūsų svetainės, autentiškumo patikra ir transporto priemonių blokų failai.
Licencija
API licencijuojama pagal vairuotojų skaičių ir už ją atsiskaitoma kasmet. Ar licencijos failas tikras, Container tikrina pats pagal jo skaitmeninį parašą, tam jam nereikia ryšio su mumis. Kai vairuotojas per galiojimo laikotarpį analizuojamas pirmą kartą, Container paprašo mūsų licencijų serverio skirti jam vairuotojo vietą. Pasibaigus mokamai licencijai, Container dar 14 dienų toliau atlieka analizę, kad ji nesustotų, jei pratęsimas ateina keliomis dienomis vėliau. Kainą nurodome pagal užklausą, nes ji priklauso nuo parko dydžio.
Be ryšio su licencijų serveriu
Vairuotojus, kurie jau turi vairuotojo vietą, Container toliau analizuoja ir be ryšio su mūsų licencijų serveriu 30 dienų nuo paskutinio prisijungimo, su bandomąja licencija 14 dienų. Naujiems vairuotojams mokama licencija turi rezervą tam atvejui, jei mūsų licencijų serveris ilgiau nei minutę nepasiekiamas. Rezervas yra dešimtadalis vairuotojo vietų, bet ne mažiau kaip 2 vietos per galiojimo laikotarpį, taigi esant 30 vietų rezervas yra 3 vietos. Tam Container reikia savo aplanko serveryje. Apie šiuos vairuotojus jis praneša vėliau, kai tik licencijų serveris vėl pasiekiamas. Bandomoji licencija rezervo neturi.
Kas išeina iš serverio
Kortelių failai apdorojami On-Prem, t. y. jūsų tinkle, ir niekada mums neperduodami. Vairuotojo kodą Container apskaičiuoja jūsų serveryje iš vairuotojo kortelės ir jūsų slaptojo rakto, kurio mes niekada negauname. Iš kodo negalime nustatyti, kas yra vairuotojas. Tačiau su jūsų raktu kodą galima vėl susieti su vairuotoju, todėl pagal BDAR jis priskiriamas asmens duomenims. Paskutinius 20 pranešimų, kuriuos Container nuo paleidimo išsiuntė mūsų licencijų serveriui, galite gauti iš Container ir perskaityti tokius, kokie jie buvo prieš juos užšifruojant.
Sąsajos dokumentacija yra adresu docs.scernetta.com ir kuriama iš OpenAPI failo. Ji prasideda vadovu apie paleidimą, licenciją ir klaidų tvarkymą bei aprašo kiekvieną galinį tašką su jo parametrais.Į dokumentaciją
Jei norite naudoti API, parašykite mums, kokias sistemas norėtumėte prijungti ir apie kiek vairuotojų ar transporto priemonių kalbama. Tada susisieksime dėl prieigos.