Επισκόπηση API

Διεύθυνση βάσης

Κάθε διαδρομή αυτής της αναφοράς βρίσκεται κάτω από τη βάση του προϊόντος (ένα πρόθεμα για κάθε προϊόν στον κοινό τομέα):

https://filodos.gr/filodos-dashboard/api/scoring

Πριν από τις 2026-10-10 το προϊόν είχε την ονομασία Avlo. Δύο παλαιότερες διευθύνσεις βάσης στον παλιό τομέα εξακολουθούν να λειτουργούν. Απαντούν όπως πριν και δεν ανακατευθύνουν:

https://avloinnovation.gr/api/scoring
https://avloinnovation.gr/avlo-fleet-management/api/scoring

Αυτές οι διευθύνσεις λειτουργούν μέχρι να λήξουν οι παλιοί τομείς (περίπου Σεπτέμβριο 2027). Αλλάξτε κάθε ροή δεδομένων, κάθε σύνδεση ERP και κάθε πελάτη webhook σε https://filodos.gr πριν από την ημερομηνία αυτή. Τα παλιά κλειδιά API και οι παλιές κεφαλίδες webhook συνεχίζουν επίσης να λειτουργούν. Δείτε την ενότητα Ταυτοποίηση.

Η παλαιότερη μορφή, https://filodos.gr/api/scoring, εξυπηρετεί τα ίδια endpoints και συνεχίζει να λειτουργεί για τις υπάρχουσες ροές. Οι νέες διασυνδέσεις χρησιμοποιούν τη μορφή με το πρόθεμα του προϊόντος. Όλα τα αιτήματα και οι απαντήσεις είναι JSON. Όλες οι αναγνώσεις ταξινομούνται από το νεότερο στο παλαιότερο, εκτός αν η σελίδα λέει κάτι άλλο.

Διαδρομές με έκδοση

Οι αναγνώσεις ροών υπάρχουν και κάτω από το πρόθεμα /v1/, με σταθερές διαδρομές: /v1/fleet, /v1/trips, /v1/events, /v1/telemetry, /v1/telemetry/samples, /v1/scores, /v1/drivers, /v1/assignments, /v1/positions, /v1/visits, /v1/reports/daily, /v1/reports/weekly, /v1/reports/history, /v1/analytics/daily, /v1/analytics/trips, /v1/analytics/events, /v1/analytics/visits και /v1/analytics/vehicles. Κάθε μία δέχεται τις τεκμηριωμένες παραμέτρους, θέλει το δικαίωμα κλειδιού της και επιστρέφει JSON. Χτίστε τις νέες διασυνδέσεις πάνω στο /v1/: αυτές οι διαδρομές δεν αλλάζουν, ενώ οι διαδρομές χωρίς έκδοση μπορεί να εξελιχθούν. Οι παράμετροι και οι μορφές είναι σε μία σελίδα για κάθε λειτουργία αυτής της αναφοράς.

curl "https://filodos.gr/filodos-dashboard/api/scoring/v1/trips?device_id=12" \
  -H "Authorization: Bearer [REDACTED]…"

Δύο διαπιστευτήρια

Και τα δύο μπαίνουν στην κεφαλίδα Authorization ως διαπιστευτήριο bearer:

Authorization: Bearer <token-or-key>

• Διακριτικό εισόδου (token). Το POST /auth/login με οργανισμό, email και κωδικό επιστρέφει ένα διακριτικό που λήγει. Χρησιμοποιήστε το για διαδραστικά εργαλεία και σενάρια μίας χρήσης. Δείτε Ταυτοποίηση.
• Κλειδί API. Μια τιμή που αρχίζει με filodos_. Τη δημιουργεί ένας διαχειριστής στη σελίδα Organization → API keys. Δεν λήγει ποτέ μέχρι να ανακληθεί, και έχει δικαιώματα (scopes) που ορίζουν ακριβώς ποιες ομάδες αναγνώσεων μπορεί να καλεί. Χρησιμοποιήστε το για ροές από διακομιστή σε διακομιστή. Δείτε Διαχείριση κλειδιών API και τον οδηγό ρύθμισης.

Τα κλειδιά δεν γράφουν ποτέ. Τα endpoints διαχείρισης (κλειδιά, webhooks, χρήστες) θέλουν είσοδο διαχειριστή.

Πεδίο οργανισμού

Κάθε ανάγνωση φιλτράρεται στον οργανισμό του διαπιστευτηρίου. Ένας αριθμός συσκευής, αριθμός οδηγού ή όνομα από άλλον οργανισμό διαβάζεται ως άγνωστο — το API απαντά 404 και δεν επιβεβαιώνει ότι υπάρχει. Αντιστοιχίστε πινακίδες και ονόματα οδηγών μία φορά με τη λίστα του στόλου και μετά διαβάζετε με πρόγραμμα.

Χρονοσφραγίδες

Οι χρονοσφραγίδες είναι κείμενα ISO-8601 που έχουν πάντα τη μετατόπιση από την UTC, για παράδειγμα 2026-10-05T08:00:00+00:00. Ο πίνακας ελέγχου δείχνει την τοπική ώρα του στόλου (Ευρώπη/Αθήνα). Το API επιστρέφει τις αποθηκευμένες χρονικές στιγμές — μετατρέψτε τις στο δικό σας σύστημα για προβολή.

Κωδικοί σφαλμάτων

Κωδικός	Σημασία
400	Λάθος συνδυασμός παραμέτρων (το μήνυμα λέει ποιος).
401	Το διαπιστευτήριο λείπει, έληξε ή ανακλήθηκε. Συνδεθείτε ξανά ή αντικαταστήστε το κλειδί.
403	Έγκυρο διαπιστευτήριο, χωρίς άδεια εδώ: endpoint μόνο για διαχειριστές, δικαίωμα κλειδιού που λείπει, ή είσοδος οδηγού εκτός του πεδίου της.
404	Άγνωστος αριθμός — ή αριθμός άλλου οργανισμού, που διαβάζεται με τον ίδιο τρόπο.
422	Μη έγκυρη είσοδος: λάθος μορφή ημερομηνίας, κενό όνομα, άγνωστο δικαίωμα ή γεγονός.
429	Πάρα πολλά αιτήματα σε endpoint με όριο ρυθμού (προπαραγγελίες, αποστολή αναφορών με email).
502 / 503	Μια εξωτερική εξάρτηση απέτυχε (ένας παραλήπτης webhook, ο διακομιστής αλληλογραφίας) ή δεν είναι ρυθμισμένη.