Ροή οχημάτων

GET/v1/analytics/vehicles

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

Χρησιμοποιήστε την ως πίνακα αναφοράς. Συνδέστε τις άλλες ροές με αυτήν μέσω του device_id.

Παράμετρος	Υποχρεωτική	Σημειώσεις
limit	Όχι	Γραμμές ανά σελίδα, από 1 έως 5000. Προεπιλογή 1000.
offset	Όχι	Η πρώτη γραμμή που επιστρέφεται. Προεπιλογή 0. Χρησιμοποιήστε το next_offset της απάντησης για την επόμενη σελίδα.

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

Παράδειγμα

Αίτημα:

curl 'https://filodos.gr/filodos-dashboard/api/scoring/v1/analytics/vehicles?limit=5000' \
  -H "Authorization: Bearer filodos_REPLACE_WITH_YOUR_KEY"

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

{
  "rows": [
    {
      "device_id": 43,
      "vehicle_name": "IKX-1234",
      "unique_id": "018271406491",
      "model": "V7 Pro",
      "category": "truck",
      "status": "online",
      "last_update": "2026-10-05T10:14:03+03:00",
      "current_driver_names": "Nikos Papadopoulos",
      "recorded_distance_km": 18432.7,
      "last_trip_at": "2026-10-05T09:02:41+03:00"
    },
    {
      "device_id": 44,
      "vehicle_name": "IKY-5678",
      "unique_id": "018271406502",
      "model": null,
      "category": "van",
      "status": "offline",
      "last_update": "2026-10-04T19:40:11+03:00",
      "current_driver_names": null,
      "recorded_distance_km": 9120.4,
      "last_trip_at": "2026-10-04T18:55:20+03:00"
    }
  ],
  "total": 2,
  "limit": 5000,
  "offset": 0,
  "next_offset": null
}

Στο Excel

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

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

Πεδία

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

Πεδίο	Τύπος	Σημασία
device_id	ακέραιος	Ο αριθμός συσκευής στο Filodos.
vehicle_name	κείμενο	Το όνομα του οχήματος, συνήθως η πινακίδα.
unique_id	κείμενο	Το αναγνωριστικό της συσκευής (για συσκευή JT/T808, ο αριθμός τηλεφώνου του τερματικού).
model	κείμενο ή null	Το μοντέλο της συσκευής, αν έχει οριστεί.
category	κείμενο ή null	Η κατηγορία του οχήματος στον χάρτη, αν έχει οριστεί.
status	κείμενο	online, offline ή unknown.
last_update	χρονοσφραγίδα ή null	Η ώρα της τελευταίας αναφοράς της συσκευής.
current_driver_names	κείμενο ή null	Οι οδηγοί που είναι συνδεδεμένοι με το όχημα τώρα.
recorded_distance_km	αριθμός	Η συνολική απόσταση διαδρομών που κατέγραψε το Filodos. Δεν είναι το οδόμετρο του οχήματος.
last_trip_at	χρονοσφραγίδα ή null	Η ώρα έναρξης της πιο πρόσφατης διαδρομής.

Το ερώτημα Power Query στέλνει τα since και until σε όλες τις ροές. Αυτή η ροή τα αγνοεί.

Σφάλματα

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

Κωδικός	Αιτία
401	Λείπει η κεφαλίδα Authorization, ή το κλειδί είναι άγνωστο ή ανακλημένο.
403	Το κλειδί δεν έχει το δικαίωμα analytics:read, ή η είσοδος είναι είσοδος οδηγού.
422	Το limit ή το offset είναι εκτός ορίων.
503	Η τρέχουσα λίστα συσκευών δεν είναι διαθέσιμη. Δοκιμάστε ξανά αργότερα.