Sama analyysi On-Prem-Containerina verkossanne
API on sama analyysiydin kuin Desktop-ohjelmassa, paketoituna Container-imageksi, jota käytätte On-Prem eli omalla palvelimella tai klusterissanne. Järjestelmänne lähettävät korttitiedostot HTTP:n kautta Containerille ja saavat analyysin takaisin JSON-muodossa. Container pitää korttitiedostot vain keskusmuistissa. Se ei tallenna niitä levylle eikä kirjoita niitä mihinkään lokitiedostoon. Korttitiedostoja ja tuloksia se ei lähetä meille. Jotta voimme laskea, kuinka monta kuljettajaa analysoitte lisenssillänne, se muodostaa yhteyden lisenssipalvelimeemme osoitteessa license.scernetta.com käynnistyksen jälkeen, noin 6 tunnin välein ja uuden kuljettajan tullessa mukaan. Lisenssipalvelin saa tällöin lisenssitiedostonne tekstin yrityksenne nimineen, Containerin versionumeron, muutamia teknisiä tarkistusarvoja ja jokaisesta uudesta kuljettajasta kuljettajakoodin. Kuljettajakoodin Container laskee palvelimellanne kuljettajakortista ja salaisesta avaimestanne.
Kenelle tämä on tarkoitettu
Tämä on tarkoitettu yrityksille, joilla on oma TMS tai ERP ja jotka haluavat jatkokäsitellä analyysin siellä. Telematiikkatoimittajat, jotka joka tapauksessa jo keräävät korttitietoja, voivat tarkastuttaa ne suoraan, ja palveluntarjoajat, jotka analysoivat kuljettajakortteja monille asiakkaille, säästyvät kiertotieltä Desktop-ohjelman kautta.
Miten se etenee
Saatte meiltä lisenssitiedoston. Ennen ensimmäistä käynnistystä luotte kerran Container-imagen komennolla salaisen avaimen, josta Container laskee kuljettajakoodit. Käyttäkää tätä avainta kaikissa asennuksissa ja säilyttäkää siitä kopio. Container toimii palvelimella verkossanne ja tarvitsee siellä oman kansion, johon se kirjaa, millä kuljettajilla on jo kuljettajapaikka. Palvelimen on voitava tavoittaa license.scernetta.com suoraan tai HTTP-välityspalvelimenne kautta. Järjestelmänne kirjautuvat API-avaimella ja välittävät .ddd-tiedostot HTTP:n kautta, yksittäin tai kuljettajakohtaisesti niputettuina, ja Container yhdistää ne täsmälleen samoin kuin Desktop-ohjelma tekee. Takaisin tulee JSON, jonka voitte jatkokäsitellä suoraan ja jossa ovat vuorot, rikkomukset valitussa näkymässä, ennusteet ja ei arvioitavissa olevat ajanjaksot.
Koko kalustolle kerralla on Batch-päätepiste. Lataatte kaikki tiedostot yhdessä pyynnössä, Container kohdistaa ne itse kuljettajille ja laskee taustalla. Jokaiselle pyynnön uudelle kuljettajalle Container varaa kuljettajapaikan jo pyyntöä lähetettäessä. Jos vapaat kuljettajapaikat eivät riitä kaikille uusille kuljettajille, se hylkää koko pyynnön eikä varaa yhtään paikkaa. Edistymisen ja kuljettajakohtaiset tulokset kysytte Job-ID:n kautta.
Sama ydin
Desktop-ohjelma ja API laskevat samalla koodilla. Samasta tiedostosta ja samassa näkymässä API toimittaa samat tulokset kuin ohjelma, datana.
Kaksi näkymää
Jokainen vastaus sisältää toisen kahdesta rikkomuslistasta. Oletuksena on tiukka näkymä, joka johtaa jokaisen havainnon asetuksen tekstistä ja nimeää siihen liittyvän artiklan. EU-lainsäädännön mukaan voitte sen sijaan pyytää viitenäkymän, joka on kalibroitu vakiintuneen ohjelmiston tulokseen. Sveitsin sääntöjen ARV 1 ja ARV 2 mukaan käytössä on vain tiukka näkymä. Oma päätepiste toimittaa luettelon säännöistä lähdeviitteineen.
Raportit
Desktop-ohjelman raportti tulee myös API:n kautta, HTML-muodossa tai CSV-taulukoina zip-paketissa. Lisäksi lähdeluettelo, joka kirjaa, mikä ladattu tiedosto kattaa minkäkin päivän.
Aitous
Kuljettajakortin tai ajoneuvoyksikön latauksen allekirjoitukset ja varmenteet voidaan tarkastaa API:n kautta. Vastaus kertoo, mitä varmennettiin. Ensimmäisen korttisukupolven allekirjoituksia tämä versio ei vielä tarkasta, mikä ei ole merkki manipuloinnista.
Ajoneuvoyksikkö
Myös ajoneuvon lataustiedosto voidaan lukea. Näette, mitkä kortit olivat asetettuina tiettynä ajanjaksona ja ketkä kuljettajat niillä ajoivat.
Sukupolvet
Luetaan sukupolven 1 sekä sukupolven 2 kuljettajakortit, mukaan lukien versio 2. Ajoneuvoyksiköiden tiedostoja API lukee vain sukupolven 2 muodoissa.
OpenAPI
Rajapinta on kuvattu OpenAPI-3.1-määrittelynä, jonka Container itse tarjoaa. Dokumentaatio osoitteessa docs.scernetta.com luodaan siitä.
Miten kuljettajat lasketaan
Jokainen kuljettajakortti, jonka analysoitte lisenssinne voimassaolokauden aikana, lasketaan kerran kuljettajaksi riippumatta siitä, kuinka usein sen analysoitte. Jos kuljettaja saa uusitun kortin tai korvaavan kortin, hän pysyy samana kuljettajana. Jos hän saa kortin toisesta maasta, hänet lasketaan uudeksi kuljettajaksi. Kuljettaja säilyttää kuljettajapaikkansa voimassaolokauden loppuun asti, vaikka hän lähtisi yrityksestänne sitä ennen. Laskenta koskee kaikkia asennuksianne yhdessä, myös testiasennusta. Verkkosivustomme esimerkkikortti, aitouden tarkastus ja ajoneuvoyksiköiden tiedostot eivät vie kuljettajapaikkaa.
Lisenssi
API lisensoidaan kuljettajien määrän mukaan ja laskutetaan vuosittain. Lisenssitiedoston aitouden Container tarkastaa itse sen digitaalisesta allekirjoituksesta, eikä se tarvitse siihen yhteyttä meihin. Kun kuljettaja analysoidaan voimassaolokauden aikana ensimmäistä kertaa, Container pyytää lisenssipalvelimeltamme hänelle kuljettajapaikan. Kun maksettu lisenssi umpeutuu, Container jatkaa laskentaa vielä 14 päivää, jotta analyysi ei pysähdy, jos uusiminen tulee muutaman päivän myöhässä. Hinnan kerromme pyynnöstä, koska se riippuu kaluston koosta.
Ilman yhteyttä lisenssipalvelimeen
Kuljettajia, joilla on jo kuljettajapaikka, Container analysoi edelleen myös ilman yhteyttä lisenssipalvelimeemme, 30 päivää viimeisestä yhteydestä, kokeilulisenssillä 14 päivää. Uusia kuljettajia varten maksetulla lisenssillä on varakiintiö siltä varalta, että lisenssipalvelimemme ei ole tavoitettavissa yli minuutin ajan. Varakiintiö on kymmenesosa kuljettajapaikoista, kuitenkin vähintään 2 paikkaa voimassaolokautta kohti, 30 paikalla siis 3. Sitä varten Container tarvitsee kansionsa palvelimella. Nämä kuljettajat se ilmoittaa jälkikäteen heti, kun lisenssipalvelin on taas tavoitettavissa. Kokeilulisenssillä ei ole varakiintiötä.
Mitä palvelimelta lähtee
Korttitiedostot käsitellään On-Prem eli verkossanne, eikä niitä koskaan siirretä meille. Kuljettajakoodin Container laskee palvelimellanne kuljettajakortista ja salaisesta avaimestanne, jota emme koskaan saa. Emme pysty päättelemään koodista, kuka kuljettaja on. Avaimenne avulla koodi voidaan kuitenkin yhdistää takaisin kuljettajaan, minkä vuoksi kuljettajakoodi on yleisen tietosuoja-asetuksen mukaan henkilötieto. Viimeiset 20 viestiä, jotka Container on käynnistyksensä jälkeen lähettänyt lisenssipalvelimellemme, voitte hakea Containerista ja lukea siinä muodossa, jossa ne olivat ennen salausta.
Rajapinnan dokumentaatio sijaitsee osoitteessa docs.scernetta.com ja luodaan OpenAPI-tiedostosta. Se alkaa oppaalla käyttöönotosta, lisenssistä ja virheenkäsittelystä ja kuvaa jokaisen päätepisteen parametreineen.Dokumentaatioon
Jos haluatte ottaa API:n käyttöön, kirjoittakaa meille, mitkä järjestelmät haluatte liittää ja kuinka monesta kuljettajasta tai ajoneuvosta on kyse. Otamme silloin yhteyttä ja toimitamme käyttöoikeuden.