Ρύθμιση κλειδιών API

Δημιουργία κλειδιού

1. Συνδεθείτε ως διαχειριστής και ανοίξτε Organization → API keys.
2. Γράψτε ένα όνομα, για παράδειγμα SoftOne feed.
3. Επιλέξτε τα δικαιώματα που χρειάζεται η ροή (δείτε παρακάτω).
4. Πατήστε Create key. Η τιμή του κλειδιού εμφανίζεται μία φορά — αντιγράψτε την τώρα. Δεν εμφανίζεται ποτέ ξανά.

Δώστε την τιμή σε αυτόν που φτιάχνει τη ροή. Μπαίνει στην κεφαλίδα Authorization ως διαπιστευτήριο bearer, στο ίδιο σημείο όπου ο πίνακας ελέγχου βάζει το δικό του διακριτικό εισόδου. Μετά η λίστα δείχνει μόνο το πρόθεμα του κλειδιού, ποτέ την τιμή.

Επιλογή δικαιωμάτων

Κάθε δικαίωμα ανοίγει μία ομάδα αναγνώσεων, μόνο για τον δικό σας οργανισμό. Ένα κλειδί χωρίς το αντίστοιχο δικαίωμα παίρνει 403 σε εκείνο το endpoint. Τα κλειδιά δεν γράφουν ποτέ τίποτα.

• devices:read — η λίστα του στόλου.
• trips:read — διαδρομές ανά όχημα, και οι διαδρομές ενός οδηγού.
• events:read — συμβάντα οδήγησης ανά όχημα, επισκέψεις ζωνών, και τα συμβάντα ενός οδηγού.
• telemetry:read — συνόψεις πακέτων του «μαύρου κουτιού» και τα δείγματά τους ανά δευτερόλεπτο.
• scores:read — αποθηκευμένες βαθμολογίες οχημάτων.
• drivers:read — συνόψεις οδηγών, λίστες οδηγών και ιστορικό αναθέσεων.
• positions:read — αποθηκευμένα στίγματα GPS ανά όχημα.
• reports:read — ημερήσιες, εβδομαδιαίες συνόψεις και ιστορικό.
• analytics:read — επίπεδοι πίνακες όλου του στόλου για εργαλεία BI: ημερήσιες μετρήσεις, διαδρομές, συμβάντα, επισκέψεις ζωνών και οχήματα.

Μια τυπική ροή χιλιομέτρων θέλει devices:read και trips:read. Μια ροή BI θέλει analytics:read. Μια ροή επιβεβαίωσης επισκέψεων θέλει επίσης events:read. Ξεκινήστε με λίγα δικαιώματα — μπορείτε να δημιουργήσετε ευρύτερο κλειδί αργότερα.

Ανάκληση κλειδιού

Πατήστε Revoke στη γραμμή του κλειδιού και επιβεβαιώστε. Οι ροές που το χρησιμοποιούν παίρνουν 401 από εκείνη τη στιγμή. Η γραμμή μένει στη λίστα με την ένδειξη «ανακλήθηκε», έτσι το πρόθεμα παραμένει αναγνωρίσιμο. Η ανάκληση δεν αναιρείται — δημιουργήστε νέο κλειδί αν η ροή χρειάζεται ακόμη πρόσβαση.