Същият анализ като On-Prem Container във Вашата мрежа
API е същото ядро за анализ като в настолната програма, опаковано като Container image, което използвате On-Prem, тоест на собствен сървър или във Вашия клъстер. Вашите системи изпращат файловете на картите по HTTP към Container-а и получават анализа обратно като JSON. Container-ът държи файловете от картите само в оперативната памет. Той не ги записва на диска и не ги вписва в нито един лог файл. Файловете от картите и резултатите той не изпраща до нас. За да можем да преброим колко водачи анализирате с Вашия лиценз, той се свързва с нашия лицензен сървър на адрес license.scernetta.com, а именно след стартирането, приблизително на всеки 6 часа и при нов водач. При това лицензният сървър получава текста на Вашия лицензен файл с името на Вашата фирма, номера на версията на Container-а, някои технически контролни стойности и по един код на водача за всеки нов водач. Кода на водача Container-ът изчислява на Вашия сървър от картата на водача и Вашия таен ключ.
За кого е предназначено
Предназначено е за автопаркове със собствен TMS или ERP, които искат да обработят анализа там. Телематичните доставчици, които и без това вече събират данни от картите, могат да ги проверяват директно, а доставчиците на услуги, които анализират карти на водачи за много клиенти, си спестяват заобиколния път през настолна програма.
Как протича това
Получавате от нас лицензен файл. Преди първото стартиране създавате еднократно, с команда от Container image, таен ключ, от който Container-ът изчислява кодовете на водачите. Използвайте този ключ на всички инсталации и пазете негово копие. Container-ът работи на сървър във Вашата мрежа и там се нуждае от собствена папка, в която отбелязва кои водачи вече имат място за водач. Сървърът трябва да има достъп до license.scernetta.com, директно или през Вашия HTTP прокси. Вашите системи се удостоверяват с API ключ и предават .ddd файловете по HTTP, поотделно или групирани по водач, и Container-ът ги обединява по същия начин, както го прави настолната програма. Обратно получавате JSON със смените, нарушенията в избрания изглед, прогнозите и периодите, които не могат да се оценят. Можете директно да го обработвате по-нататък.
За цял автопарк наведнъж има Batch endpoint. Качвате всички файлове в една заявка, Container-ът сам ги разпределя по водачи и ги обработва във фонов режим. За всеки нов водач в заявката Container-ът заема място за водач още при подаването ѝ. Ако свободните места за водачи не стигат за всички нови водачи, той отхвърля цялата заявка и не заема нито едно място. Напредъка и резултатите за всеки водач проверявате чрез Job-ID.
Едно и също ядро
Настолната програма и API работят с един и същ код. За един и същ файл и един и същ изглед API доставя същите резултати като програмата, като данни.
Два изгледа
Всеки отговор съдържа един от двата списъка с нарушения. По подразбиране е зададен строгият изглед, който извежда всяко заключение от текста на регламента и посочва съответния член. По правото на ЕС можете вместо това да заявите референтния изглед, който е калибриран спрямо резултата на утвърден софтуер. По швейцарските правила ARV 1 и ARV 2 има само строг изглед. Отделен endpoint доставя каталога на правилата заедно с техните препратки.
Отчети
Отчетът от настолната програма е достъпен и през API, като HTML или като CSV таблици в Zip. Към него се прилага манифест на източниците, който отбелязва кой качен файл покрива кой ден.
Автентичност
Подписите и сертификатите на карта на водача или на изтегляне от бордово устройство могат да се проверят през API. Отговорът казва какво е било потвърдено. Тази версия все още не проверява подписите на картите от първо поколение и това не е признак за манипулация.
Бордово устройство
Може да се разчете и файлът с изтегляне от превозното средство. Виждате кои карти са били поставени през даден период и кои водачи са управлявали с тях.
Поколения
Разчитат се карти на водачи от поколение 1, както и от поколение 2, включително версия 2. API разчита файлове от бордови устройства само във форматите на поколение 2.
OpenAPI
Интерфейсът е описан като спецификация OpenAPI 3.1, която самият Container предоставя. Документацията на docs.scernetta.com се създава от нея.
Как се броят водачите
Всяка карта на водача, която анализирате през срока на Вашия лиценз, се брои веднъж като водач, независимо колко често я анализирате. Ако водачът получи подновена карта или заместваща карта, той остава същият водач. Ако получи карта от друга държава, той се брои като нов водач. Водачът запазва своето място за водач до края на срока, дори ако напусне Вашето предприятие преди това. Броенето обхваща всички Ваши инсталации заедно, включително тестова инсталация. Място за водач не заемат примерната карта от нашия уебсайт, проверката за автентичност и файловете от бордови устройства.
Лиценз
API се лицензира според броя на водачите и се фактурира годишно. Дали лицензният файл е истински, Container-ът проверява сам по неговия цифров подпис и за това не се нуждае от връзка с нас. Когато даден водач бъде анализиран за първи път през срока, Container-ът заявява при нашия лицензен сървър място за водач за него. Ако платен лиценз изтече, Container-ът продължава да анализира още 14 дни, за да не спре анализът, когато подновяването дойде няколко дни по-късно. Цената съобщаваме при запитване, защото зависи от размера на автопарка.
Без връзка с лицензния сървър
Водачите, които вече имат място за водач, Container-ът продължава да анализира и без връзка с нашия лицензен сървър, в продължение на 30 дни от последната връзка, а с пробен лиценз 14 дни. За нови водачи платеният лиценз има резерв за случаите, когато нашият лицензен сървър е недостъпен повече от една минута. Резервът е една десета от местата за водачи, но най-малко 2 места за всеки срок, тоест при 30 места това са 3. За това Container-ът се нуждае от своята папка на сървъра. Тези водачи той съобщава допълнително, щом лицензният сървър отново стане достъпен. Пробният лиценз няма резерв.
Какво напуска сървъра
Файловете от картите се обработват On-Prem, тоест във Вашата мрежа, и никога не се предават до нас. Кода на водача Container-ът изчислява на Вашия сървър от картата на водача и Вашия таен ключ, който ние никога не получаваме. От кода не можем да разберем кой е водачът. С Вашия ключ обаче кодът може отново да бъде свързан с даден водач, затова съгласно ОРЗД той спада към личните данни. Последните 20 съобщения, които Container-ът е изпратил до нашия лицензен сървър от стартирането си, можете да получите от Container-а и да прочетете във вида, който са имали преди криптирането.
Документацията на интерфейса се намира на docs.scernetta.com и се създава от OpenAPI файла. Тя започва с ръководство за стартиране, лиценз и обработка на грешки и описва всеки endpoint с неговите параметри.Към документацията
Ако искате да използвате API, пишете ни кои системи желаете да свържете и за колко водачи или превозни средства става въпрос. Тогава ще се свържем с Вас и ще Ви предоставим достъп.