Αναφορές
Αποθηκευμένες συνόψεις οδήγησης ανά όχημα: μία ημέρα, μία εβδομάδα ή ένα διάστημα ημερών. Τα κλειδιά API θέλουν το δικαίωμα reports:read. Μέρος της τεκμηρίωσης.
GET/v1/reports/daily
Επιστρέφει μία αποθηκευμένη ημερήσια σύνοψη μαζί με την ανάλυση κάθε διαδρομής: απόσταση, χρόνο οδήγησης και ρελαντί, πλήθος συμβάντων, κλίμακες σοβαρότητας υπερβάσεων ταχύτητας, και τον δείκτη κόστους (cost: ώρες ρελαντί × €/ώρα, απότομα συμβάντα × €/συμβάν, νυχτερινά km × €/km, και το σύνολο — προσωρινές τιμές μέχρι τη βαθμονόμηση). Το day είναι YYYY-MM-DD σε τοπική ώρα στόλου (Ευρώπη/Αθήνα). Μια ημέρα που δεν υπολογίστηκε ποτέ δίνει 404 — οι συνόψεις υπολογίζονται κάθε νύχτα, ή κατ' απαίτηση από τη σελίδα Reports του πίνακα ελέγχου.
curl 'https://filodos.gr/filodos-dashboard/api/scoring/v1/reports/daily?device_id=43&day=2026-10-04' \
-H "Authorization: Bearer [REDACTED]…"| Παράμετρος | Υποχρεωτική | Σημειώσεις |
|---|---|---|
device_id | Ναι | Ο αριθμός συσκευής Traccar από το GET /devices. Ο αριθμός άλλου οργανισμού δίνει 404. |
day | Ναι | YYYY-MM-DD, Ευρώπη/Αθήνα. Μια ημερομηνία σε λάθος μορφή δίνει 422. |
idle_eur_per_hour | Όχι | Δική σας τιμή ρελαντί για το cost. Προεπιλογή η ρύθμιση του διακομιστή. Μια αρνητική τιμή δίνει 422. |
harsh_eur_per_event | Όχι | Δική σας τιμή ανά απότομο συμβάν για το cost. Προεπιλογή η ρύθμιση του διακομιστή. |
night_eur_per_km | Όχι | Δική σας τιμή ανά νυχτερινό χιλιόμετρο για το cost. Προεπιλογή η ρύθμιση του διακομιστή. |
GET/v1/reports/weekly
Επιστρέφει μία σύνοψη εβδομάδας Δευτέρα–Κυριακή σε τοπική ώρα στόλου: τα σύνολα της εβδομάδας και τις επτά ημέρες (μια ημέρα χωρίς υπολογισμένη σύνοψη σημειώνεται, ποτέ δεν συμπληρώνεται με μηδενικά), ένα κείμενο περιγραφής, τη βαθμολογία ασφάλειας της εβδομάδας, που υπολογίζεται τη στιγμή του αιτήματος, και τον δείκτη κόστους για τα σύνολα της εβδομάδας (ίδια μορφή cost με την ημερήσια). Το week είναι οποιαδήποτε ημερομηνία μέσα στην εβδομάδα — μετατρέπεται στη Δευτέρα της.
curl 'https://filodos.gr/filodos-dashboard/api/scoring/v1/reports/weekly?device_id=43&week=2026-10-04' \
-H "Authorization: Bearer [REDACTED]…"| Παράμετρος | Υποχρεωτική | Σημειώσεις |
|---|---|---|
device_id | Ναι | Ο αριθμός συσκευής Traccar από το GET /devices. |
week | Ναι | Οποιαδήποτε ημερομηνία YYYY-MM-DD μέσα στην εβδομάδα, Ευρώπη/Αθήνα. |
idle_eur_per_hour | Όχι | Δική σας τιμή ρελαντί για το cost. Προεπιλογή η ρύθμιση του διακομιστή. Μια αρνητική τιμή δίνει 422. |
harsh_eur_per_event | Όχι | Δική σας τιμή ανά απότομο συμβάν για το cost. Προεπιλογή η ρύθμιση του διακομιστή. |
night_eur_per_km | Όχι | Δική σας τιμή ανά νυχτερινό χιλιόμετρο για το cost. Προεπιλογή η ρύθμιση του διακομιστή. |
GET/v1/reports/history
Δίνει τις τελευταίες N αποθηκευμένες ημερήσιες συνόψεις, από την παλαιότερη, χωρίς γραμμές ανά διαδρομή — τα δεδομένα για γραφήματα τάσης. Οι ημέρες χωρίς υπολογισμένη σύνοψη λείπουν.
curl 'https://filodos.gr/filodos-dashboard/api/scoring/v1/reports/history?device_id=43&days=30' \
-H "Authorization: Bearer [REDACTED]…"| Παράμετρος | Υποχρεωτική | Σημειώσεις |
|---|---|---|
device_id | Ναι | Ο αριθμός συσκευής Traccar από το GET /devices. |
days | Όχι | Μήκος διαστήματος. Προεπιλογή 30, μέγιστο 90. |