Filodos

Ρύθμιση webhooks

Για διαχειριστές: στείλτε τέλη διαδρομών, αφίξεις σε ζώνες, κρίσιμους συναγερμούς και την ημερήσια αναφορά στα δικά σας συστήματα. Μέρος της τεκμηρίωσης.

Συνδρομή ενός endpoint

  1. Ετοιμάστε στο σύστημά σας μια διεύθυνση HTTPS που δέχεται αιτήματα POST με JSON, για παράδειγμα https://erp.example.com/filodos-hook.
  2. Συνδεθείτε ως διαχειριστής και ανοίξτε Organization → Webhooks.
  3. Γράψτε ένα όνομα, επικολλήστε τη διεύθυνση και επιλέξτε τα γεγονότα που θέλετε.
  4. Πατήστε Create subscription. Το μυστικό υπογραφής εμφανίζεται μία φορά — αντιγράψτε το τώρα. Το σύστημά σας το χρησιμοποιεί για να ελέγχει ότι κάθε παράδοση έρχεται πραγματικά από το Filodos.

Κάθε παράδοση έχει δύο κεφαλίδες: X-Filodos-Signature (υπογραφή του σώματος του μηνύματος με το μυστικό σας) και X-Filodos-Delivery (μοναδικός αριθμός για κάθε παράδοση, για να αγνοεί το σύστημά σας μια επανάληψη). Δώστε όλες τις λεπτομέρειες στον προγραμματιστή σας: η σελίδα Γεγονότα webhooks έχει τις μορφές των μηνυμάτων και ένα παράδειγμα ελέγχου.

Έως τον Σεπτέμβριο του 2027, κάθε παράδοση περιέχει τις ίδιες τιμές και στις παλιές κεφαλίδες X-Avlo-Signature και X-Avlo-Delivery. Αλλάξτε το σύστημά σας στις κεφαλίδες X-Filodos- πριν από αυτή την ημερομηνία.

Τα πέντε γεγονότα

  • trip.ended — μια διαδρομή κλείνει, με την απόστασή της. Χρησιμοποιήστε το για καταχώριση χιλιομέτρων.
  • geofence.enter και geofence.exit — ένα συνδεδεμένο όχημα περνά το όριο μίας από τις ζώνες σας. Χρησιμοποιήστε τα ως ώρες παράδοσης.
  • alarm.critical — SOS, σύγκρουση ή ανατροπή. Χρησιμοποιήστε το για να ανοίξετε συμβάν.
  • report.daily — τελειώνει η νυχτερινή αποστολή αναφορών με email, με το πλήθος των email που στάλθηκαν.

Τα γεγονότα ζωνών στέλνονται μόνο για οχήματα συνδεδεμένα με τη ζώνη — συνδέστε τα πρώτα στη σελίδα Geofences.

Επαναλήψεις και επανάληψη αποστολής

Κάθε ειδοποίηση αποθηκεύεται πριν από την πρώτη αποστολή. Μια αποστολή που αποτυγχάνει — σφάλμα δικτύου, λήξη χρόνου, ή απάντηση 429 ή 5xx — επαναλαμβάνεται αυτόματα μετά από 1 λεπτό, 5 λεπτά, 30 λεπτά, 2 ώρες και 12 ώρες. Κάθε άλλη απάντηση 4xx αποτυγχάνει αμέσως: ο παραλήπτης απορρίπτει το ίδιο το μήνυμα, άρα μια νέα αποστολή δεν αλλάζει τίποτα.

Ανοίξτε τη συνδρομή για να δείτε κάθε παράδοση: sent, pending με την ώρα της επόμενης προσπάθειας, ή failed με την αιτία. Ξαναστείλτε οποιαδήποτε αποθηκευμένη παράδοση με το Replay — φεύγει με νέο αριθμό παράδοσης και την ένδειξη "replay": true. Για προγραμματιστές, οι ίδιες γραμμές είναι στο GET /webhooks/{id}/deliveries και στο POST /webhooks/{id}/deliveries/{delivery_id}/replay — δείτε Διαχείριση webhooks.

Δοκιμή και επίλυση προβλημάτων

Πατήστε Send test στη γραμμή της συνδρομής. Το Filodos στέλνει αμέσως ένα υπογεγραμμένο ping webhook.test και δείχνει την απάντηση του συστήματός σας. Αν η απάντηση δεν είναι 200, ελέγξτε ότι η διεύθυνση είναι προσβάσιμη από το διαδίκτυο, δέχεται POST και απαντά μέσα σε 10 δευτερόλεπτα. Διαγράψτε τη συνδρομή όταν δεν τη χρειάζεστε πια — η διαγραφή ισχύει αμέσως.