Διαχείριση κλειδιών API
Δημιουργήστε, δείτε και ανακαλέστε κλειδιά API του οργανισμού μέσω προγράμματος. Και τα τρία endpoints θέλουν είσοδο διαχειριστή — ένα κλειδί API δεν μπορεί να διαχειριστεί κλειδιά. Μέρος της τεκμηρίωσης.
POST/api-keys
Δημιουργεί ένα κλειδί για τον οργανισμό του διαχειριστή και επιστρέφει την τιμή του μία φορά — φυλάξτε την αμέσως, γιατί μετά το Filodos κρατά μόνο το hash. Έγκυρα δικαιώματα: devices:read, trips:read, events:read, telemetry:read, scores:read, drivers:read, positions:read, reports:read. Κενό όνομα, άγνωστο δικαίωμα ή κενή λίστα δικαιωμάτων δίνει 422.
curl -X POST https://filodos.gr/filodos-dashboard/api/scoring/api-keys \
-H "Authorization: Bearer eyJhbGciOi…" \
-H 'Content-Type: application/json' \
-d '{"name": "SoftOne feed", "scopes": ["devices:read", "trips:read", "events:read"]}'
{"id": 3, "name": "SoftOne feed", "prefix": "filodos_6633",
"scopes": ["devices:read", "trips:read", "events:read"],
"created_at": "2026-10-05T08:00:00+00:00",
"last_used_at": null, "revoked_at": null,
"api_key": "filodos_6633dd4e…"}GET/api-keys
Δίνει τα κλειδιά του οργανισμού, από το νεότερο — ίδια μορφή με την παραπάνω, χωρίς την τιμή api_key. Τα ανακλημένα κλειδιά μένουν στη λίστα με συμπληρωμένο το revoked_at. Κάθε χρήση ενημερώνει το last_used_at.
curl https://filodos.gr/filodos-dashboard/api/scoring/api-keys \
-H "Authorization: Bearer eyJhbGciOi…"DELETE/api-keys/{id}
Ανακαλεί ένα κλειδί του οργανισμού του διαχειριστή. Οι ροές που το χρησιμοποιούν παίρνουν 401 από εκείνη τη στιγμή. Ο αριθμός κλειδιού άλλου οργανισμού δίνει 404. Η ανάκληση δεν αναιρείται — δημιουργήστε νέο κλειδί.
curl -X DELETE https://filodos.gr/filodos-dashboard/api/scoring/api-keys/3 \
-H "Authorization: Bearer eyJhbGciOi…"
{"id": 3, "revoked": true}