Διαχείριση webhooks

Δημιουργήστε, δείτε, διαγράψτε και δοκιμάστε συνδρομές ειδοποιήσεων μέσω προγράμματος. Και τα τέσσερα endpoints θέλουν είσοδο διαχειριστή. Το περιεχόμενο κάθε γεγονότος είναι στη σελίδα Γεγονότα webhooks. Μέρος της τεκμηρίωσης.

POST /webhooks
GET /webhooks
DELETE /webhooks/{id}
POST /webhooks/{id}/test
GET /webhooks/{id}/deliveries
POST /webhooks/{id}/deliveries/{delivery_id}/replay

POST/webhooks

Δημιουργεί συνδρομή για ένα endpoint του οργανισμού του διαχειριστή και επιστρέφει το μυστικό υπογραφής μία φορά — φυλάξτε το αμέσως. Η διεύθυνση URL πρέπει να είναι https (το http λειτουργεί μόνο για loopback, για τοπικές δοκιμές). Έγκυρα γεγονότα: geofence.enter, geofence.exit, alarm.critical, trip.ended, report.daily. Κενό όνομα, άγνωστο γεγονός ή λάθος διεύθυνση URL δίνει 422.

curl -X POST https://filodos.gr/filodos-dashboard/api/scoring/webhooks \
  -H "Authorization: Bearer eyJhbGciOi…" \
  -H 'Content-Type: application/json' \
  -d '{"name": "ERP visits", "url": "https://erp.example.com/filodos-hook",
       "events": ["trip.ended", "geofence.enter", "geofence.exit"]}'

{"id": 5, "name": "ERP visits", "url": "https://erp.example.com/filodos-hook",
 "events": ["geofence.enter", "geofence.exit", "trip.ended"],
 "active": true, "created_at": "2026-10-05T08:00:00+00:00",
 "secret": "9f2c…"}

GET/webhooks

Δίνει τις συνδρομές του οργανισμού, από τη νεότερη — ίδια μορφή με την παραπάνω, χωρίς το secret.

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

DELETE/webhooks/{id}

Διαγράφει μία συνδρομή του οργανισμού του διαχειριστή, αμέσως. Ο αριθμός άλλου οργανισμού δίνει 404.

curl -X DELETE https://filodos.gr/filodos-dashboard/api/scoring/webhooks/5 \
  -H "Authorization: Bearer eyJhbGciOi…"

{"id": 5, "deleted": true}

POST/webhooks/{id}/test

Στέλνει αμέσως στη συνδρομή ένα υπογεγραμμένο ping webhook.test και επιστρέφει τον κωδικό HTTP του παραλήπτη — ο πιο γρήγορος τρόπος να ελέγξετε όλη την αλυσίδα πριν φτάσουν πραγματικά γεγονότα. Ένας παραλήπτης που δεν απαντά δίνει 502 με την αιτία.

curl -X POST https://filodos.gr/filodos-dashboard/api/scoring/webhooks/5/test \
  -H "Authorization: Bearer eyJhbGciOi…"

{"id": 5, "url": "https://erp.example.com/filodos-hook", "status": 200}

GET/webhooks/{id}/deliveries

Δίνει τις νεότερες γραμμές παράδοσης μιας συνδρομής, από τη νεότερη. Κάθε γραμμή δείχνει το status (sent, pending με next_retry_at, ή failed με last_error), το πλήθος προσπαθειών attempts και τον αποθηκευμένο φάκελο envelope. Χρησιμοποιήστε το για να βρείτε ποιες ειδοποιήσεις δεν έφτασαν ποτέ στον παραλήπτη.

curl "https://filodos.gr/filodos-dashboard/api/scoring/webhooks/5/deliveries?limit=20" \
  -H "Authorization: Bearer [REDACTED]…"

POST/webhooks/{id}/deliveries/{delivery_id}/replay

Ξαναστέλνει μία αποθηκευμένη παράδοση με νέο αριθμό παράδοσης, με την ένδειξη "replay": true στον φάκελο. Η προσπάθεια γίνεται αμέσως και εμφανίζεται στη λίστα παραδόσεων όπως κάθε άλλη αποστολή. Χρησιμοποιήστε το αφού διορθώσετε τον παραλήπτη, για να ανακτήσετε ειδοποιήσεις που απέτυχαν. Ο αριθμός συνδρομής ή παράδοσης άλλου οργανισμού δίνει 404.

curl -X POST https://filodos.gr/filodos-dashboard/api/scoring/webhooks/5/deliveries/9f3a41b2-7c0e-4d9f-8a1b-2c3d4e5f6071/replay \
  -H "Authorization: Bearer [REDACTED]…"

{"delivery_id": "c41b…", "status": "sent"}