Η ίδια ανάλυση ως On-Prem container στο δίκτυό σας
Το API είναι ο ίδιος πυρήνας ανάλυσης όπως στο πρόγραμμα desktop, συσκευασμένος ως εικόνα container, το οποίο εκτελείτε On-Prem, δηλαδή σε έναν δικό σας διακομιστή ή στο cluster σας. Τα συστήματά σας στέλνουν τα αρχεία της κάρτας μέσω HTTP στο container και λαμβάνουν την ανάλυση πίσω ως JSON. Το container κρατά τα αρχεία της κάρτας μόνο στη μνήμη. Δεν τα αποθηκεύει στον σκληρό δίσκο και δεν τα γράφει σε κανένα αρχείο καταγραφής. Αρχεία κάρτας και αποτελέσματα δεν τα στέλνει σε εμάς. Για να μπορούμε να μετράμε πόσους οδηγούς αναλύετε με την άδεια χρήσης σας, συνδέεται με τον διακομιστή αδειών χρήσης μας στο license.scernetta.com, συγκεκριμένα μετά την εκκίνηση, περίπου κάθε 6 ώρες και όταν εμφανίζεται νέος οδηγός. Ο διακομιστής αδειών χρήσης λαμβάνει τότε το κείμενο του αρχείου άδειας χρήσης σας με την επωνυμία της εταιρείας σας, τον αριθμό έκδοσης του container, ορισμένες τεχνικές τιμές ελέγχου και, για κάθε νέο οδηγό, έναν κωδικό οδηγού. Τον κωδικό οδηγού τον υπολογίζει το container στον διακομιστή σας από την κάρτα οδηγού και το μυστικό κλειδί σας.
Για ποιους προορίζεται
Προορίζεται για στόλους με δικό τους TMS ή ERP, που θέλουν να επεξεργαστούν την ανάλυση εκεί. Πάροχοι τηλεματικής, που ούτως ή άλλως συλλέγουν ήδη δεδομένα καρτών, μπορούν να τα ελέγχουν απευθείας με αυτό, και πάροχοι υπηρεσιών, που αναλύουν κάρτες οδηγού για πολλούς πελάτες, αποφεύγουν την παράκαμψη μέσω ενός προγράμματος desktop.
Πώς εξελίσσεται αυτό
Λαμβάνετε από εμάς ένα αρχείο άδειας χρήσης. Πριν από την πρώτη εκκίνηση δημιουργείτε μία φορά, με μια εντολή από την εικόνα container, ένα μυστικό κλειδί, από το οποίο το container υπολογίζει τους κωδικούς οδηγού. Χρησιμοποιήστε αυτό το κλειδί σε όλες τις εγκαταστάσεις και φυλάξτε ένα αντίγραφο. Το container εκτελείται σε έναν διακομιστή στο δίκτυό σας και χρειάζεται εκεί έναν δικό του φάκελο, στον οποίο καταγράφει ποιοι οδηγοί έχουν ήδη θέση οδηγού. Ο διακομιστής πρέπει να έχει πρόσβαση στο license.scernetta.com, απευθείας ή μέσω του διακομιστή μεσολάβησης HTTP (proxy) σας. Τα συστήματά σας ταυτοποιούνται με ένα κλειδί API και παραδίδουν τα αρχεία .ddd μέσω HTTP, μεμονωμένα ή ομαδοποιημένα ανά οδηγό, και το container τα συνενώνει ακριβώς όπως το κάνει το πρόγραμμα desktop. Ως απάντηση λαμβάνετε ένα JSON με τις βάρδιες, τις παραβάσεις στην επιλεγμένη όψη, τις προβλέψεις και τα μη αξιολογήσιμα χρονικά διαστήματα, το οποίο μπορείτε να επεξεργαστείτε απευθείας.
Για έναν ολόκληρο στόλο μεμιάς υπάρχει ένα τελικό σημείο batch. Ανεβάζετε όλα τα αρχεία σε ένα αίτημα, το container τα αντιστοιχίζει μόνο του στους οδηγούς και τα επεξεργάζεται στο παρασκήνιο. Για κάθε νέο οδηγό στο αίτημα, το container δεσμεύει μια θέση οδηγού ήδη κατά την υποβολή. Αν οι ελεύθερες θέσεις οδηγών δεν επαρκούν για όλους τους νέους οδηγούς, απορρίπτει ολόκληρο το αίτημα και δεν δεσμεύει καμία θέση. Την πρόοδο και τα αποτελέσματα ανά οδηγό τα ζητάτε μέσω ενός αναγνωριστικού εργασίας (job id).
Ίδιος πυρήνας
Το πρόγραμμα desktop και το API υπολογίζουν με τον ίδιο κώδικα. Για το ίδιο αρχείο και την ίδια όψη, το API παραδίδει τα ίδια αποτελέσματα με το πρόγραμμα, ως δεδομένα.
Δύο όψεις
Κάθε απάντηση περιέχει μία από τις δύο λίστες παραβάσεων. Προεπιλογή είναι η αυστηρή όψη, η οποία εξάγει κάθε εύρημα από το κείμενο του κανονισμού και αναφέρει το σχετικό άρθρο. Βάσει του δικαίου της ΕΕ μπορείτε αντί αυτής να ζητήσετε την όψη αναφοράς, η οποία είναι βαθμονομημένη ως προς το αποτέλεσμα του καθιερωμένου λογισμικού. Βάσει των ελβετικών κανόνων ARV 1 και ARV 2 υπάρχει μόνο η αυστηρή όψη. Ένα ξεχωριστό τελικό σημείο παραδίδει τον κατάλογο των κανόνων με τις παραπομπές τους.
Αναφορές
Η αναφορά από το πρόγραμμα desktop έρχεται και μέσω του 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. Αρχίζει με έναν οδηγό για την έναρξη, την άδεια χρήσης και τη διαχείριση σφαλμάτων και περιγράφει κάθε τελικό σημείο με τις παραμέτρους του.Προς την τεκμηρίωση
Αν θέλετε να χρησιμοποιήσετε το API, γράψτε μας ποια συστήματα θέλετε να συνδέσετε και για πόσους οδηγούς ή οχήματα πρόκειται. Θα επικοινωνήσουμε τότε με μια πρόσβαση.