Δοκιμή διασύνδεσης

Δεν υπάρχει ακόμη οργανισμός δοκιμών (sandbox) — δοκιμάστε στον δικό σας οργανισμό με κλειδί περιορισμένων δικαιωμάτων και μετά διευρύνετε. Μέρος της τεκμηρίωσης.

Δοκιμή αναγνώσεων
Δοκιμή ειδοποιήσεων
Διάγνωση σφαλμάτων
Λίστα ελέγχου πριν από τη λειτουργία

Δοκιμή αναγνώσεων

Δημιουργήστε κλειδί με ακριβώς τα δικαιώματα που χρειάζεται η ροή σας, για παράδειγμα devices:read και trips:read για χιλιόμετρα.

Διαβάστε τον στόλο και μετά τις διαδρομές ενός οχήματος:

curl https://filodos.gr/filodos-dashboard/api/scoring/devices \
  -H "Authorization: Bearer filodos_…"
curl 'https://filodos.gr/filodos-dashboard/api/scoring/trips?device_id=43' \
  -H "Authorization: Bearer filodos_…"

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

Δοκιμή ειδοποιήσεων

Στρέψτε μια συνδρομή σε ένα εργαλείο επιθεώρησης αιτημάτων (οποιαδήποτε υπηρεσία δείχνει τα εισερχόμενα HTTP, ή το δικό σας endpoint δοκιμών) και πατήστε Send test — ή καλέστε POST /webhooks/{id}/test.
Ελέγξτε το X-Filodos-Signature με το μυστικό σας, με το παράδειγμα της σελίδας Γεγονότα webhooks, πριν εμπιστευτείτε οποιοδήποτε πεδίο.
Μετά περιμένετε πραγματική δραστηριότητα: τελειώστε μια διαδρομή, οδηγήστε ένα συνδεδεμένο όχημα μέσα από μια ζώνη, ή αφήστε τη νυχτερινή αποστολή να τελειώσει.

Διάγνωση σφαλμάτων

Βλέπετε	Σημαίνει	Κάντε αυτό
`401` σε κάθε κλήση	Το διακριτικό εισόδου έληξε ή το κλειδί ανακλήθηκε.	Συνδεθείτε ξανά, ή δημιουργήστε νέο κλειδί και ανακαλέστε το παλιό.
`403` σε ένα endpoint	Το κλειδί δεν έχει αυτό το δικαίωμα.	Δημιουργήστε κλειδί με το δικαίωμα, ή περιορίστε τη ροή στα δικαιώματα που έχει.
`404` για γνωστό αριθμό	Λάθος αριθμός — ή αριθμός άλλου οργανισμού.	Αντιστοιχίστε ξανά με το `GET /devices` του δικού σας οργανισμού.
`422` στη δημιουργία	Κενό όνομα, άγνωστο δικαίωμα ή γεγονός, λάθος διεύθυνση URL.	Διαβάστε το μήνυμα. Λέει ποιο πεδίο φταίει.
Ping δοκιμής `502`	Το endpoint σας δεν είναι προσβάσιμο ή είναι πολύ αργό.	Κάντε το προσβάσιμο από το διαδίκτυο, να δέχεται `POST` και να απαντά μέσα σε 10 δευτερόλεπτα.
Καμία παράδοση, κανένα σφάλμα	Δεν συνέβη τίποτα: οι διαδρομές είναι ακόμη ανοιχτές, τα οχήματα δεν είναι συνδεδεμένα με ζώνες, ή δεν υπήρξε οδήγηση.	Ελέγξτε πρώτα τον πίνακα ελέγχου — τα webhooks στέλνουν μόνο ό,τι δείχνει ο πίνακας ελέγχου.

Λίστα ελέγχου πριν από τη λειτουργία

Το κλειδί έχει μόνο τα δικαιώματα που καλεί η ροή — επιβεβαιωμένο με μια δοκιμή που δίνει 403.
Ο παραλήπτης ελέγχει κάθε υπογραφή, αποθηκεύει τους αριθμούς παράδοσης και αγνοεί τις επαναλήψεις.
Ο παραλήπτης απαντά μέσα σε 10 δευτερόλεπτα. Η ροή ξαναδιαβάζει το API για ό,τι λείπει (οι παραδόσεις δεν έχουν ακόμη επαναλήψεις).
Η αντιστοίχιση πινακίδων και οδηγών γίνεται με πρόγραμμα από το GET /devices, όχι από παλιό αντίγραφο.
Ένα κλειδί δοκιμών από την ανάπτυξη που ανακλήθηκε μένει ανακλημένο.