Ροή ημερήσιων μετρήσεων

GET/v1/analytics/daily

Επιστρέφει μία γραμμή για κάθε ημέρα οχήματος που έχει υπολογισμένη ημερήσια σύνοψη. Ημέρες χωρίς υπολογισμένη σύνοψη δεν εμφανίζονται. Οι γραμμές ταξινομούνται κατά ημέρα και μετά κατά αριθμό συσκευής.

Χρησιμοποιήστε αυτή τη ροή για αναφορές απόστασης, χρόνου οδήγησης, ρελαντί και ταχύτητας ανά ημέρα, όχημα ή οδηγό.

Παράμετρος	Υποχρεωτική	Σημειώσεις
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/daily?since=2026-10-01&until=2026-10-31&limit=5000' \
  -H "Authorization: Bearer filodos_REPLACE_WITH_YOUR_KEY"

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

{
  "rows": [
    {
      "device_id": 43,
      "vehicle_name": "IKX-1234",
      "driver_names": "Nikos Papadopoulos",
      "day": "2026-10-01",
      "trip_count": 4,
      "distance_km": 128.4,
      "drive_hours": 3.2,
      "idle_hours": 0.4,
      "night_km": 0.0,
      "overspeed_km": 2.1,
      "overspeed_seconds": 96.0,
      "max_over_limit_kmh": 18.0,
      "over_mild_km": 1.5,
      "over_moderate_km": 0.5,
      "over_severe_km": 0.1,
      "overspeed_implied_km": 0.0,
      "unknown_limit_km": 6.3,
      "harsh_brake_count": 1,
      "harsh_accel_count": 0,
      "signal_harsh_count": 0,
      "longest_drive_minutes": 74.0,
      "fatigue_flag": false
    },
    {
      "device_id": 44,
      "vehicle_name": "IKY-5678",
      "driver_names": "Anna Georgiou, Kostas Nikolaou",
      "day": "2026-10-01",
      "trip_count": 6,
      "distance_km": 212.9,
      "drive_hours": 5.1,
      "idle_hours": 0.9,
      "night_km": 14.2,
      "overspeed_km": 0.0,
      "overspeed_seconds": 0.0,
      "max_over_limit_kmh": 0.0,
      "over_mild_km": 0.0,
      "over_moderate_km": 0.0,
      "over_severe_km": 0.0,
      "overspeed_implied_km": 0.0,
      "unknown_limit_km": 9.8,
      "harsh_brake_count": 0,
      "harsh_accel_count": 2,
      "signal_harsh_count": 0,
      "longest_drive_minutes": 281.0,
      "fatigue_flag": true
    }
  ],
  "total": 62,
  "limit": 5000,
  "offset": 0,
  "next_offset": null
}

Στο Excel

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

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

Πεδία

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

Πεδίο	Τύπος	Σημασία
device_id	ακέραιος	Ο αριθμός συσκευής στο Filodos. Συνδέει αυτόν τον πίνακα με τις άλλες ροές.
vehicle_name	κείμενο ή null	Το όνομα του οχήματος, συνήθως η πινακίδα. null όταν η τρέχουσα λίστα συσκευών δεν είναι διαθέσιμη.
driver_names	κείμενο ή null	Όλοι οι οδηγοί που συνδέθηκαν με το όχημα εκείνη την ημέρα, χωρισμένοι με κόμμα. null όταν δεν συνδέθηκε κανείς.
day	ημερομηνία	Η ημέρα του στόλου (ώρα Ευρώπης/Αθήνας).
trip_count	ακέραιος	Ο αριθμός των διαδρομών της ημέρας.
distance_km	αριθμός	Η απόσταση σε χιλιόμετρα.
drive_hours	αριθμός	Ο συνολικός χρόνος διαδρομών σε ώρες. Περιλαμβάνει τον χρόνο ρελαντί.
idle_hours	αριθμός	Ο χρόνος με αναμμένη μηχανή και ταχύτητα κάτω από 3 km/h, σε ώρες.
night_km	αριθμός	Η απόσταση από 22:00 έως 06:00 τοπική ώρα.
overspeed_km	αριθμός	Η απόσταση πάνω από αναρτημένο όριο ταχύτητας.
overspeed_seconds	αριθμός	Ο χρόνος πάνω από αναρτημένο όριο ταχύτητας, σε δευτερόλεπτα.
max_over_limit_kmh	αριθμός	Η μεγαλύτερη υπέρβαση του ορίου, σε km/h.
over_mild_km	αριθμός	Απόσταση με υπέρβαση έως 10 km/h πάνω από αναρτημένο όριο.
over_moderate_km	αριθμός	Απόσταση με υπέρβαση από 10 έως 20 km/h πάνω από αναρτημένο όριο.
over_severe_km	αριθμός	Απόσταση με υπέρβαση πάνω από 20 km/h πάνω από αναρτημένο όριο.
overspeed_implied_km	αριθμός	Απόσταση πάνω από όριο που το Filodos συνάγει από τον τύπο του δρόμου. Δεν περιλαμβάνεται στο overspeed_km.
unknown_limit_km	αριθμός	Απόσταση σε δρόμους χωρίς γνωστό όριο ταχύτητας.
harsh_brake_count	ακέραιος	Απότομα φρεναρίσματα που βρίσκει το Filodos από τα δεδομένα ταχύτητας.
harsh_accel_count	ακέραιος	Απότομες επιταχύνσεις που βρίσκει το Filodos από τα δεδομένα ταχύτητας.
signal_harsh_count	ακέραιος	Απότομα φρεναρίσματα κοντά σε φανάρι. Περιλαμβάνονται και στο harsh_brake_count.
longest_drive_minutes	αριθμός	Η μεγαλύτερη συνεχής οδήγηση χωρίς διάλειμμα 15 λεπτών.
fatigue_flag	λογική τιμή	true όταν μια συνεχής οδήγηση ξεπέρασε τις 4,5 ώρες.

Η ροή διαβάζει αποθηκευμένες ημερήσιες συνόψεις. Δεν εκτελεί ανάλυση και δεν δημιουργεί συνόψεις που λείπουν. Ο πίνακας ελέγχου ή η νυχτερινή αναφορά πρέπει πρώτα να υπολογίσει κάθε ημέρα.

Σφάλματα

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

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