L-istess analiżi bħala Container On-Prem fin-netwerk tagħkom
L-API hija l-istess qalba tal-analiżi bħal fil-programm tad-desktop, ippakkjata bħala image ta' Container li tħaddmuh On-Prem, jiġifieri fuq server tagħkom stess jew fil-cluster tagħkom. Is-sistemi tagħkom jibagħtu l-fajls tal-karti lill-Container permezz ta' HTTP u jirċievu l-analiżi lura bħala JSON. Il-Container iżomm il-fajls tal-karti fil-memorja biss. Ma jaħżinhomx fuq il-hard disk u ma jiktibhom f'ebda fajl tal-log. Il-fajls tal-karti u r-riżultati ma jibgħathomx lilna. Biex inkunu nistgħu ngħoddu kemm-il sewwieq tanalizzaw bil-liċenzja tagħkom, jgħaqqad ruħu mas-server tal-liċenzji tagħna fuq license.scernetta.com, jiġifieri wara li jibda, bejn wieħed u ieħor kull 6 sigħat u meta jkun hemm sewwieq ġdid. Is-server tal-liċenzji jirċievi b'hekk it-test tal-fajl tal-liċenzja tagħkom bl-isem tal-kumpanija tagħkom, in-numru tal-verżjoni tal-Container, xi valuri tekniċi ta' verifika u, għal kull sewwieq ġdid, kodiċi tas-sewwieq. Il-kodiċi tas-sewwieq il-Container jikkalkulah fuq is-server tagħkom mill-karta tas-sewwieq u miċ-ċavetta sigrieta tagħkom.
Għal min huwa maħsub
Huwa maħsub għall-flotot bit-TMS jew l-ERP tagħhom stess, li jridu jkomplu jaħdmu l-analiżi hemmhekk. Il-fornituri tat-telematika, li diġà jiġbru d-data tal-karti xorta waħda, jistgħu jġibuha vverifikata direttament, u l-fornituri ta' servizzi, li janalizzaw karti tas-sewwieqa għal ħafna klijenti, jiffrankaw it-tidwir minn programm tad-desktop.
Kif jgħaddi dan
Tirċievu mingħandna fajl tal-liċenzja. Qabel l-ewwel tħaddim toħolqu darba ċavetta sigrieta b'kmand mill-image tal-Container, u minnha l-Container jikkalkula l-kodiċijiet tas-sewwieqa. Użaw din iċ-ċavetta fuq l-installazzjonijiet kollha u żommu kopja tagħha. Il-Container jaħdem fuq server fin-netwerk tagħkom u hemm jeħtieġ folder tiegħu stess, fejn iżomm rekord ta' liema sewwieqa diġà għandhom slot tas-sewwieq. Is-server irid ikun jista' jilħaq license.scernetta.com, direttament jew permezz tal-proxy HTTP tagħkom. Is-sistemi tagħkom jidentifikaw ruħhom b'ċavetta tal-API u jgħaddu l-fajls .ddd permezz ta' HTTP, wieħed wieħed jew miġbura għal kull sewwieq, u l-Container jgħaqqadhom eżatt kif jagħmel il-programm tad-desktop. Lura jiġi JSON bix-xiftijiet, bil-ksur fil-perspettiva magħżula, bil-previżjonijiet u bil-perjodi li mhumiex valutabbli, li tistgħu tkomplu tipproċessaw direttament.
Għal flotta sħiħa f'daqqa hemm endpoint tal-batch. Ittellgħu l-fajls kollha f'talba waħda, il-Container jattribwihom huwa stess lis-sewwieqa tagħhom u jikkalkula fl-isfond. Għal kull sewwieq ġdid fit-talba, il-Container jokkupa slot tas-sewwieq diġà meta tintbagħat it-talba. Jekk is-slots tas-sewwieq liberi ma jkunux biżżejjed għas-sewwieqa l-ġodda kollha, jirrifjuta t-talba kollha u ma jokkupa l-ebda slot. Il-progress u r-riżultati għal kull sewwieq tistaqsu għalihom permezz ta' job ID.
L-istess qalba
Il-programm tad-desktop u l-API jikkalkulaw bl-istess kodiċi. Għall-istess fajl u l-istess perspettiva, l-API tagħti l-istess riżultati bħall-programm, bħala data.
Żewġ perspettivi
Kull tweġiba jkun fiha waħda miż-żewġ listi tal-ksur. L-għażla predefinita hija l-perspettiva stretta, li tislet kull sejba mit-test tar-regolament u ssemmi l-artikolu miegħu. Skont il-liġi tal-UE tistgħu minflok titolbu l-perspettiva ta' referenza, li hija kkalibrata skont ir-riżultat ta' softwer stabbilit. Skont ir-regoli Żvizzeri ARV 1 u ARV 2 hemm biss il-perspettiva stretta. Endpoint apposta jagħti l-katalgu tar-regoli bir-referenzi tagħhom.
Rapporti
Ir-rapport mill-programm tad-desktop jiġi wkoll permezz tal-API, bħala HTML jew bħala tabelli CSV fi zip. Miegħu manifest tas-sorsi li jżomm liema fajl mtella' jipprova liema jum.
Awtentiċità
Il-firem u ċ-ċertifikati ta' karta tas-sewwieq jew ta' download ta' unità tal-vettura jistgħu jiġu vverifikati permezz tal-API. It-tweġiba tgħid x'ġie vverifikat. Il-firem tal-ewwel ġenerazzjoni tal-karti din il-verżjoni għadha ma tivverifikahomx, u dan mhux sinjal ta' manipulazzjoni.
Unità tal-vettura
Anke l-fajl tad-download tal-vettura jista' jinqara. Taraw liema karti kienu mdaħħla f'perjodu u liema sewwieqa saqu bihom.
Ġenerazzjonijiet
Jinqraw karti tas-sewwieqa tal-ġenerazzjoni 1 kif ukoll tal-ġenerazzjoni 2 inkluża l-verżjoni 2. Il-fajls tal-unitajiet tal-vetturi l-API taqrahom biss fil-formati tal-ġenerazzjoni 2.
OpenAPI
L-interfaċċa hija deskritta bħala speċifikazzjoni OpenAPI 3.1, li l-Container innifsu joħroġha. Id-dokumentazzjoni fuq docs.scernetta.com tinħoloq minnha.
Kif jingħaddu s-sewwieqa
Kull karta tas-sewwieq li tanalizzaw matul it-terminu tal-liċenzja tagħkom tgħodd darba bħala sewwieq, irrispettivament minn kemm-il darba tanalizzawha. Jekk sewwieq jirċievi karta mġedda jew karta ta' sostituzzjoni, jibqa' l-istess sewwieq. Jekk jirċievi karta minn pajjiż ieħor, jgħodd bħala sewwieq ġdid. Sewwieq iżomm is-slot tas-sewwieq tiegħu sa tmiem it-terminu, anke jekk iħalli l-kumpanija tagħkom qabel. L-għadd isir fuq l-installazzjonijiet kollha tagħkom flimkien, inkluża installazzjoni tat-test. Il-karta ta' kampjun mill-website tagħna, il-verifika tal-awtentiċità u l-fajls mill-unitajiet tal-vetturi ma jokkupaw l-ebda slot tas-sewwieq.
Liċenzja
L-API tiġi liċenzjata skont l-għadd tas-sewwieqa u tiġi ffatturata kull sena. Il-Container jivverifika huwa stess permezz tal-firma diġitali jekk il-fajl tal-liċenzja huwiex ġenwin, u għal dan ma jeħtieġ l-ebda konnessjoni magħna. Meta sewwieq jiġi analizzat għall-ewwel darba matul it-terminu, il-Container jitlob slot tas-sewwieq għalih mis-server tal-liċenzji tagħna. Jekk liċenzja mħallsa tiskadi, il-Container jibqa' jikkalkula għal 14-il jum ieħor, biex l-analiżi ma tieqafx jekk it-tiġdid jasal ftit jiem tard. Il-prezz insemmuh fuq talba, għax jiddependi mid-daqs tal-flotta.
Mingħajr konnessjoni mas-server tal-liċenzji
Is-sewwieqa li diġà għandhom slot tas-sewwieq, il-Container ikompli janalizzahom anke mingħajr konnessjoni mas-server tal-liċenzji tagħna, għal 30 jum mill-aħħar konnessjoni, u b'liċenzja ta' prova għal 14-il jum. Għal sewwieqa ġodda, liċenzja mħallsa għandha riżerva f'każ li s-server tal-liċenzji tagħna ma jkunx jista' jintlaħaq għal aktar minn minuta. Ir-riżerva hija għaxar parti mis-slots tas-sewwieq, iżda mill-inqas 2 slots għal kull terminu, jiġifieri 3 b'30 slot. Għal dan il-Container jeħtieġ il-folder tiegħu fuq is-server. Dawn is-sewwieqa jirrappurtahom wara, hekk kif is-server tal-liċenzji jerġa' jkun jista' jintlaħaq. Liċenzja ta' prova m'għandhiex riżerva.
X'jitlaq mis-server tagħkom
Il-fajls tal-karti jiġu pproċessati On-Prem, jiġifieri fin-netwerk tagħkom, u qatt ma jiġu trasferiti lilna. Il-kodiċi tas-sewwieq il-Container jikkalkulah fuq is-server tagħkom mill-karta tas-sewwieq u miċ-ċavetta sigrieta tagħkom, li aħna qatt ma nirċievu. Mill-kodiċi ma nistgħux nagħrfu min hu s-sewwieq. Iċ-ċavetta tagħkom, madankollu, tippermetti li l-kodiċi jerġa' jiġi assoċjat ma' sewwieq, u għalhekk skont il-GDPR il-kodiċi tas-sewwieq huwa data personali. L-aħħar 20 messaġġ li l-Container bagħat lis-server tal-liċenzji tagħna minn mindu beda tistgħu titolbuhom mill-Container u taqrawhom, kif kienu qabel il-kriptaġġ.
Id-dokumentazzjoni tal-interfaċċa tinsab fuq docs.scernetta.com u tinħoloq mill-fajl OpenAPI. Tibda b'gwida għall-bidu, il-liċenzja u l-immaniġġjar tal-iżbalji u tiddeskrivi kull endpoint bil-parametri tiegħu.Għad-dokumentazzjoni
Jekk tridu tużaw l-API, iktbulna liema sistemi tixtiequ tqabbdu u dwar kemm-il sewwieq jew vettura qed nitkellmu. Imbagħad nikkuntattjawkom b'aċċess.