Ταυτοποίηση

POST/auth/login

Συνδέεται με οργανισμό, email και κωδικό, και επιστρέφει διακριτικό bearer που ισχύει 12 ώρες. Αν λείπει ο οργανισμός, χρησιμοποιείται ο προεπιλεγμένος οργανισμός. Ένα κοινό 401 καλύπτει άγνωστο οργανισμό, άγνωστο email και λάθος κωδικό. Έτσι το endpoint δεν αποκαλύπτει ποιοι οργανισμοί ή ποιες διευθύνσεις υπάρχουν.

curl -X POST https://filodos.gr/filodos-dashboard/api/scoring/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"organization": "acme", "email": "feed@acme.example", "password": "…"}'

{"access_token": "eyJhbGciOi…", "token_type": "bearer"}

Πεδίο	Υποχρεωτικό	Σημειώσεις
organization	Όχι	Το αναγνωριστικό (slug) του οργανισμού σας, με πεζά. Κενό σημαίνει τον προεπιλεγμένο οργανισμό. Το όνομα filodos οδηγεί στον προεπιλεγμένο οργανισμό (το slug avlo) όταν κανένας άλλος οργανισμός δεν έχει αυτό το slug.
email	Ναι	Συγκρίνεται χωρίς διάκριση πεζών-κεφαλαίων μέσα στον οργανισμό σας.
password	Ναι	Φυλάξτε τον σε θησαυροφυλάκιο κωδικών, ποτέ μέσα στον κώδικα.

GET/auth/me

Επιστρέφει σε ποιον ανήκει το διαπιστευτήριο: αριθμό, email, ρόλο, οργανισμό και — για εισόδους οδηγών — τους αριθμούς των ορατών οχημάτων. Καλέστε το μετά την είσοδο για να επιβεβαιώσετε τον ρόλο και τον οργανισμό πριν διαβάσετε άλλα δεδομένα.

curl https://filodos.gr/filodos-dashboard/api/scoring/auth/me \
  -H "Authorization: Bearer eyJhbGciOi…"

Χρήση του διαπιστευτηρίου

Στείλτε το διακριτικό ή το κλειδί σε κάθε άλλη κλήση:

Authorization: Bearer <access_token or filodos_… key>

Ένα 401 σημαίνει ότι το διαπιστευτήριο λείπει, έληξε, ανακλήθηκε ή διαγράφηκε — συνδεθείτε ξανά ή αντικαταστήστε το κλειδί. Οι ροές μακράς διάρκειας χρησιμοποιούν κλειδί API αντί για νέα είσοδο κάθε 12 ώρες. Μη βάζετε ποτέ το διαπιστευτήριο στη διεύθυνση URL: οι διευθύνσεις καταγράφονται στα αρχεία πρόσβασης.

Τα κλειδιά που δημιουργήθηκαν πριν από τις 2026-10-10 αρχίζουν με avlo_. Εξακολουθούν να λειτουργούν. Τα νέα κλειδιά αρχίζουν με filodos_.