Ροή επισκέψεων ζωνών

GET/v1/analytics/visits

Επιστρέφει μία γραμμή για κάθε παραμονή σε ζώνη (geofence). Το Filodos ζευγαρώνει κάθε είσοδο σε ζώνη με την επόμενη έξοδο από την ίδια ζώνη του ίδιου οχήματος. Οι γραμμές ταξινομούνται κατά ώρα εισόδου και μετά κατά αριθμό συσκευής.

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

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

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

{
  "rows": [
    {
      "device_id": 43,
      "vehicle_name": "IKX-1234",
      "driver_name": "Nikos Papadopoulos",
      "geofence_id": 5,
      "geofence_name": "Depot Aspropyrgos",
      "zone_type": "depot",
      "entered_at": "2026-10-01T06:58:12+03:00",
      "exited_at": "2026-10-01T07:41:30+03:00",
      "duration_minutes": 43.3,
      "open": false
    },
    {
      "device_id": 44,
      "vehicle_name": "IKY-5678",
      "driver_name": "Anna Georgiou",
      "geofence_id": 12,
      "geofence_name": "Customer Kifisias 44",
      "zone_type": "customer",
      "entered_at": "2026-10-31T17:20:00+02:00",
      "exited_at": null,
      "duration_minutes": null,
      "open": true
    }
  ],
  "total": 156,
  "limit": 5000,
  "offset": 0,
  "next_offset": null
}

Στο Excel

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

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

Πεδία

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

Πεδίο	Τύπος	Σημασία
device_id	ακέραιος	Ο αριθμός συσκευής στο Filodos.
vehicle_name	κείμενο ή null	Το όνομα του οχήματος, συνήθως η πινακίδα.
driver_name	κείμενο ή null	Ο οδηγός που ήταν συνδεδεμένος με το όχημα τη στιγμή της εισόδου.
geofence_id	ακέραιος	Ο αριθμός της ζώνης.
geofence_name	κείμενο ή null	Το όνομα της ζώνης. null όταν η λίστα ζωνών δεν είναι διαθέσιμη.
zone_type	κείμενο ή null	depot (αποθήκη), customer (πελάτης), no-go (απαγορευμένη), ή null όταν η ζώνη δεν έχει τύπο.
entered_at	χρονοσφραγίδα	Η ώρα εισόδου, σε ώρα Ευρώπης/Αθήνας με μετατόπιση.
exited_at	χρονοσφραγίδα ή null	Η ώρα εξόδου. null για ανοιχτή παραμονή.
duration_minutes	αριθμός ή null	Ο χρόνος μέσα στη ζώνη. null για ανοιχτή παραμονή.
open	λογική τιμή	true όταν το διάστημα ημερομηνιών δεν έχει έξοδο για αυτή την είσοδο.

Μετρούν μόνο είσοδοι και έξοδοι μέσα στο διάστημα ημερομηνιών. Μια έξοδος χωρίς την είσοδό της στο διάστημα δεν εμφανίζεται.

Όταν ένα όχημα μπαίνει ξανά σε ζώνη πριν από έξοδο, η πρώτη παραμονή τελειώνει στη δεύτερη είσοδο.

Το total μετρά παραμονές, όχι εισόδους και εξόδους.

Σφάλματα

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

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