Ροή συμβάντων

GET/v1/analytics/events

Επιστρέφει μία γραμμή για κάθε συναγερμό ή συμβάν οδήγησης μέσα στο διάστημα ημερομηνιών. Οι γραμμές ταξινομούνται κατά ώρα συμβάντος και μετά κατά αριθμό συμβάντος.

Χρησιμοποιήστε αυτή τη ροή για ελέγχους ασφάλειας: ποια συμβάντα, ποια οχήματα, ποιοι οδηγοί και πότε. Οι είσοδοι και έξοδοι ζωνών δεν εμφανίζονται εδώ. Γι’ αυτές χρησιμοποιήστε τη ροή επισκέψεων ζωνών.

Παράμετρος	Υποχρεωτική	Σημειώσεις
since	Ναι	Πρώτη ημερομηνία του στόλου, σε μορφή YYYY-MM-DD.
until	Ναι	Τελευταία ημερομηνία του στόλου, σε μορφή YYYY-MM-DD. Και τα δύο όρια περιλαμβάνονται. Το διάστημα δεν μπορεί να ξεπερνά τις 366 ημέρες.
limit	Όχι	Γραμμές ανά σελίδα, από 1 έως 5000. Προεπιλογή 1000.
offset	Όχι	Η πρώτη γραμμή που επιστρέφεται. Προεπιλογή 0. Χρησιμοποιήστε το next_offset της απάντησης για την επόμενη σελίδα.

Στείλτε ένα κλειδί API με το δικαίωμα analytics:read στην κεφαλίδα Authorization. Ένα κλειδί διαβάζει μόνο δεδομένα του οργανισμού του. Οι κανόνες που ισχύουν για όλες τις ροές είναι στη σελίδα Αναλύσεις BI.

Παράδειγμα

Αίτημα:

curl 'https://filodos.gr/filodos-dashboard/api/scoring/v1/analytics/events?since=2026-10-01&until=2026-10-31&limit=5000' \
  -H "Authorization: Bearer filodos_REPLACE_WITH_YOUR_KEY"

Απάντηση (200). Το παράδειγμα δείχνει δύο από τις 37 γραμμές. Μια πραγματική σελίδα έχει έως limit γραμμές. Το next_offset είναι null στην τελευταία σελίδα.

{
  "rows": [
    {
      "event_id": 55120,
      "device_id": 43,
      "vehicle_name": "IKX-1234",
      "driver_names": "Nikos Papadopoulos",
      "occurred_at": "2026-10-01T08:12:40+03:00",
      "event_type": "hardBraking",
      "severity": 2,
      "trip_id": 8812
    },
    {
      "event_id": 55187,
      "device_id": 44,
      "vehicle_name": "IKY-5678",
      "driver_names": "Anna Georgiou",
      "occurred_at": "2026-10-03T14:55:02+03:00",
      "event_type": "sos",
      "severity": 3,
      "trip_id": null
    }
  ],
  "total": 37,
  "limit": 5000,
  "offset": 0,
  "next_offset": null
}

Στο Excel

1. Δημιουργήστε το ερώτημα με τα βήματα της ενότητας Excel Power Query.
2. Ορίστε Feed = "events" στο ερώτημα.
3. Επιλέξτε Κλείσιμο & φόρτωση (Close & Load).

Το φύλλο έχει τότε μία γραμμή για κάθε γραμμή της απάντησης. Μια τιμή null δίνει κενό κελί. Μερικές στήλες του παραδείγματος φαίνονται έτσι:

Πεδία

Κάθε γραμμή έχει αυτά τα πεδία, με αυτή τη σειρά. Μια χρονοσφραγίδα είναι σε μορφή ISO 8601, σε ώρα Ευρώπης/Αθήνας, με ρητή μετατόπιση ώρας.

Πεδίο	Τύπος	Σημασία
event_id	ακέραιος	Ο αριθμός συμβάντος στο Filodos.
device_id	ακέραιος	Ο αριθμός συσκευής στο Filodos.
vehicle_name	κείμενο ή null	Το όνομα του οχήματος, συνήθως η πινακίδα.
driver_names	κείμενο ή null	Οι οδηγοί που ήταν συνδεδεμένοι με το όχημα τη στιγμή του συμβάντος.
occurred_at	χρονοσφραγίδα	Η ώρα του συμβάντος, σε ώρα Ευρώπης/Αθήνας με μετατόπιση.
event_type	κείμενο	Ο τύπος του συμβάντος. Δείτε τη λίστα παρακάτω.
severity	ακέραιος	2 για συμβάν οδήγησης, 3 για συναγερμό έκτακτης ανάγκης.
trip_id	ακέραιος ή null	Η διαδρομή που περιέχει το συμβάν. null όταν το συμβάν δεν είναι μέσα σε διαδρομή.

Τα συμβάντα δεν έχουν θέση. Για να δείτε πού έγινε ένα συμβάν, βρείτε τη διαδρομή του με το trip_id στη ροή διαδρομών.

Τύποι συμβάντων

event_type	Σοβαρότητα	Σημασία
sos	3	Ο οδηγός πάτησε το κουμπί έκτακτης ανάγκης.
collision	3	Η συσκευή εντόπισε σύγκρουση.
rollover	3	Η συσκευή εντόπισε ανατροπή.
fatigueDriving	2	Η συσκευή έστειλε συναγερμό κόπωσης.
overspeed	2	Η συσκευή έστειλε συναγερμό υπερβολικής ταχύτητας.
deviceOverspeed	2	Ο διακομιστής εντόπισε ταχύτητα πάνω από το όριο της συσκευής.
hardBraking	2	Η συσκευή έστειλε συναγερμό απότομου φρεναρίσματος.
hardAcceleration	2	Η συσκευή έστειλε συναγερμό απότομης επιτάχυνσης.
hardCornering	2	Η συσκευή έστειλε συναγερμό απότομης στροφής.
adasAlarm	2	Η κάμερα έστειλε συναγερμό υποβοήθησης οδηγού (ADAS).

Σφάλματα

Μια απάντηση σφάλματος έχει σώμα JSON με πεδίο detail.

Κωδικός	Αιτία
401	Λείπει η κεφαλίδα Authorization, ή το κλειδί είναι άγνωστο ή ανακλημένο.
403	Το κλειδί δεν έχει το δικαίωμα analytics:read, ή η είσοδος είναι είσοδος οδηγού.
422	Το until είναι πριν από το since, το διάστημα ξεπερνά τις 366 ημέρες, μια ημερομηνία δεν είναι σε μορφή YYYY-MM-DD, ή το limit ή το offset είναι εκτός ορίων.