Sama greining sem On-Prem-Container í netinu þínu
API-ið er sami greiningarkjarni og í skjáborðsforritinu, pakkað sem Container-image sem þú keyrir On-Prem, það er á eigin netþjóni eða í þínum klasa. Kerfin þín senda kortaskrárnar um HTTP til Containersins og fá greininguna til baka sem JSON. Containerinn geymir kortaskrárnar aðeins í vinnsluminni. Hann vistar þær ekki á diski og skrifar þær ekki í neina annálaskrá. Kortaskrár og niðurstöður sendir hann ekki til okkar. Til þess að við getum talið hversu marga ökumenn þú greinir með leyfinu þínu, tengist hann leyfisþjóninum okkar á license.scernetta.com, nánar tiltekið eftir ræsingu, um það bil á 6 klukkustunda fresti og þegar nýr ökumaður bætist við. Leyfisþjónninn fær þá texta leyfisskrárinnar þinnar með heiti fyrirtækisins þíns, útgáfunúmer Containersins, nokkur tæknileg prófunargildi og ökumannskóða fyrir hvern nýjan ökumann. Ökumannskóðann reiknar Containerinn á netþjóninum þínum út frá ökumannskortinu og leynilyklinum þínum.
Fyrir hverja þetta er hugsað
Þetta er hugsað fyrir flota með eigin TMS eða ERP sem vilja vinna greininguna áfram þar. Fjarvöktunaraðilar, sem safna kortagögnum hvort eð er, geta látið prófa þau beint, og þjónustuaðilar, sem greina ökumannskort fyrir marga viðskiptavini, sleppa krókaleiðinni gegnum skjáborðsforrit.
Hvernig þetta gengur fyrir sig
Þú færð leyfisskrá frá okkur. Fyrir fyrstu ræsingu býrð þú einu sinni til leynilykil með skipun úr Container-image, og út frá honum reiknar Containerinn ökumannskóðana. Notaðu þennan lykil á öllum uppsetningum og geymdu afrit af honum. Containerinn keyrir á netþjóni í netinu þínu og þarf eigin möppu á honum, þar sem hann heldur skrá yfir hvaða ökumenn hafa þegar ökumannspláss. Netþjónninn verður að geta náð sambandi við license.scernetta.com, beint eða gegnum HTTP-milliþjóninn þinn. Kerfin þín skrá sig inn með API-lykli og senda .ddd-skrárnar um HTTP, eina og eina eða í búnti fyrir hvern ökumann, og Containerinn sameinar þær nákvæmlega eins og skjáborðsforritið gerir. Til baka kemur JSON með vöktunum, brotunum í valinni sýn, spánum og tímabilunum sem ekki er hægt að meta, sem þú getur unnið áfram beint.
Fyrir heilan flota í einu er til endapunktur fyrir runuvinnslu. Þú hleður öllum skránum upp í einni beiðni, Containerinn tengir þær sjálfur við ökumennina og reiknar í bakgrunni. Fyrir hvern nýjan ökumann í beiðninni tekur Containerinn ökumannspláss strax þegar beiðnin er lögð fram. Nægi laus ökumannspláss ekki fyrir alla nýju ökumennina, hafnar hann allri beiðninni og tekur ekkert ökumannspláss. Framvinduna og niðurstöðurnar fyrir hvern ökumann sækir þú um verkkenni.
Sami kjarni
Skjáborðsforritið og API-ið reikna með sama kóða. Fyrir sömu skrá og sömu sýn skilar API-ið sömu niðurstöðum og forritið, sem gögnum.
Tvær sýnir
Hvert svar inniheldur annan af brotalistunum tveimur. Sjálfgefin er stranga sýnin, sem leiðir hverja niðurstöðu af reglugerðartextanum og nefnir greinina að baki. Samkvæmt lögum ESB getur þú í staðinn sótt viðmiðunarsýnina, sem er kvörðuð eftir niðurstöðum rótgróins hugbúnaðar. Samkvæmt svissnesku reglunum ARV 1 og ARV 2 er aðeins stranga sýnin til. Sérstakur endapunktur skilar skrá yfir reglurnar með tilvísunum sínum.
Skýrslur
Skýrslan úr skjáborðsforritinu fæst líka gegnum API-ið, sem HTML eða CSV-töflur í Zip. Að auki upprunaskrá sem heldur til haga hvaða upphlaðin skrá staðfestir hvaða dag.
Áreiðanleiki
Undirskriftir og skilríki ökumannskorts eða niðurhals ökutækiseiningar má prófa gegnum API-ið. Svarið segir hvað var staðfest. Undirskriftir fyrstu kortakynslóðarinnar prófar þessi útgáfa ekki enn, það er engin vísbending um að átt hafi verið við gögnin.
Ökutækiseining
Einnig má lesa niðurhalsskrá ökutækisins. Þú sérð hvaða kort voru í tækinu á tilteknu tímabili og hvaða ökumenn óku með þeim.
Kynslóðir
Lesin eru ökumannskort af kynslóð 1 og kynslóð 2, þar með talið útgáfu 2. Skrár úr ökutækiseiningum les API-ið aðeins á sniðum kynslóðar 2.
OpenAPI
Viðmótinu er lýst sem OpenAPI-3.1-forskrift sem Containerinn afhendir sjálfur. Handbókin á docs.scernetta.com er búin til úr henni.
Hvernig ökumenn eru taldir
Hvert ökumannskort sem þú greinir á gildistíma leyfisins þíns telst einu sinni sem ökumaður, óháð því hversu oft þú greinir það. Fái ökumaður endurnýjað kort eða staðgöngukort, er hann áfram sami ökumaður. Fái hann kort frá öðru landi, telst hann nýr ökumaður. Ökumaður heldur ökumannsplássi sínu til loka gildistímans, líka þótt hann hætti fyrr hjá fyrirtækinu þínu. Talið er yfir allar uppsetningar þínar samanlagt, líka prufuuppsetningu. Ekkert ökumannspláss taka sýnishornskortið af vefsíðunni okkar, áreiðanleikaprófunin og skrár úr ökutækiseiningum.
Leyfi
API-ið er leyft eftir fjölda ökumanna og gert upp árlega. Hvort leyfisskráin er ósvikin prófar Containerinn sjálfur út frá stafrænni undirskrift hennar, og til þess þarf hann enga tengingu við okkur. Þegar ökumaður er greindur í fyrsta sinn á gildistímanum, óskar Containerinn eftir ökumannsplássi fyrir hann hjá leyfisþjóninum okkar. Renni greitt leyfi út, reiknar Containerinn áfram í 14 daga, svo að greiningin stöðvist ekki þótt endurnýjunin komi nokkrum dögum síðar. Verðið nefnum við samkvæmt beiðni, því það fer eftir stærð flotans.
Án tengingar við leyfisþjóninn
Ökumenn sem hafa þegar ökumannspláss greinir Containerinn áfram án tengingar við leyfisþjóninn okkar, í 30 daga frá síðustu tengingu, en í 14 daga með prufuleyfi. Fyrir nýja ökumenn hefur greitt leyfi varaforða, ef ekki næst samband við leyfisþjóninn okkar lengur en í eina mínútu. Varaforðinn er tíundi hluti ökumannsplássanna, þó að lágmarki 2 pláss á hvern gildistíma, og við 30 pláss er hann því 3 pláss. Til þess þarf Containerinn möppuna sína á netþjóninum. Þessa ökumenn tilkynnir hann eftir á, um leið og samband næst aftur við leyfisþjóninn. Prufuleyfi hefur engan varaforða.
Það sem fer út af netþjóninum
Kortaskrárnar eru unnar On-Prem, það er í netinu þínu, og aldrei sendar til okkar. Ökumannskóðann reiknar Containerinn á netþjóninum þínum út frá ökumannskortinu og leynilyklinum þínum, sem við fáum aldrei. Við getum ekki lesið út úr kóðanum hver ökumaðurinn er. Með lyklinum þínum er þó hægt að tengja kóðann aftur við ökumann, og þess vegna telst ökumannskóðinn til persónuupplýsinga samkvæmt GDPR. Síðustu 20 skilaboðin sem Containerinn hefur sent leyfisþjóninum okkar frá ræsingu getur þú sótt hjá Containernum og lesið, eins og þau litu út fyrir dulkóðun.
Handbók viðmótsins er á docs.scernetta.com og er búin til úr OpenAPI-skránni. Hún hefst á leiðbeiningum um ræsingu, leyfi og villumeðhöndlun og lýsir hverjum endapunkti með breytum hans.Í handbókina
Ef þú vilt nota API-ið, skrifaðu okkur hvaða kerfi þú vilt tengja og um hversu marga ökumenn eða ökutæki er að ræða. Við höfum þá samband með aðgang.