Συμβάντα

Αποθηκευμένα συμβάντα οδήγησης ανά όχημα ή ανά οδηγό, από το πιο πρόσφατο. Τα κλειδιά API θέλουν το δικαίωμα events:read. Μέρος της τεκμηρίωσης.

GET /events
GET /driver/events
Τύποι συμβάντων

GET/events

Δίνει τα αποθηκευμένα συμβάντα ενός οχήματος: σοβαρότητα 2 και 3, καθώς και εισόδους και εξόδους ζωνών, παρότι αυτές έχουν σοβαρότητα 1 (για να λειτουργούν τα φίλτρα ζωνών). Για άμεσες ειδοποιήσεις αντί για περιοδική ανάγνωση, δείτε Γεγονότα webhooks.

curl 'https://filodos.gr/filodos-dashboard/api/scoring/events?device_id=43' \
  -H "Authorization: Bearer filodos_…"

[{"id": 905, "trip_id": 812, "device_id": 43, "event_type": "overspeed",
  "occurred_at": "2026-10-05T06:20:00+00:00", "severity": 2,
  "attributes": {}}]

Παράμετρος	Υποχρεωτική	Σημειώσεις
`device_id`	Ναι	Ο αριθμός συσκευής Traccar από το `GET /devices`. Ο αριθμός άλλου οργανισμού δίνει `404`.

Το attributes περιέχει λεπτομέρειες ανάλογα με τον τύπο: geofenceId στα συμβάντα ζωνών, το όνομα του συναγερμού στους συναγερμούς, έναν αριθμό θέσης για τον δείκτη χάρτη στις ειδοποιήσεις της κάμερας.

GET/driver/events

Δίνει τα αποθηκευμένα συμβάντα ενός οδηγού σε κάθε όχημα που οδήγησε — από το πιο πρόσφατο, με την ίδια μορφή όπως το GET /events. Η απόδοση ακολουθεί το ιστορικό αναθέσεων οδηγού↔οχήματος: ένα συμβάν μετράει για όποιον ήταν συνδεδεμένος τη στιγμή που συνέβη.

curl 'https://filodos.gr/filodos-dashboard/api/scoring/driver/events?traccar_driver_id=12&limit=50' \
  -H "Authorization: Bearer filodos_…"

Παράμετρος	Υποχρεωτική	Σημειώσεις
`traccar_driver_id`	Ναι	Ο αριθμός οδηγού από τις εγγραφές οδηγών σας. Ένας άγνωστος αριθμός δίνει `404`.
`limit`	Όχι	1–1000 γραμμές ανά κλήση. Προεπιλογή 200.

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

Η σοβαρότητα πηγαίνει από 1 (μικρή) έως 3 (κρίσιμη). Τα παρακάτω ονόματα είναι οι σταθερές τύπων συμβάντων του Traccar, όχι αριθμοί μηνυμάτων του πρωτοκόλλου.

Τύπος	Σοβαρότητα	Σημειώσεις
`sos`, `collision`, `rollover`	3	Κρίσιμοι συναγερμοί. Ο καθένας στέλνει επίσης webhook `alarm.critical`.
`fatigueDriving`, `overspeed`, `deviceOverspeed`	2	Σοβαρά συμβάντα οδήγησης.
`adasAlarm`, `hardAcceleration`, `hardBraking`, `hardCornering`	2	Ανιχνεύσεις της κάμερας και απότομοι χειρισμοί.
`geofenceEnter`, `geofenceExit`	1	Διελεύσεις ζωνών από συνδεδεμένα οχήματα. Η καθεμία στέλνει επίσης webhook.