Το ParkFlow.io είναι ένας διαχειριστής καναλιών για χώρους στάθμευσης αεροδρομίων, που συνδέει πολλαπλές πηγές κρατήσεων (OTAs, μεσίτες, ιστότοπους, συναθροιστές) με φορείς εκμετάλλευσης χώρων στάθμευσης. Το ParkFlow λειτουργεί κυρίως με ένα μοντέλο βασισμένο σε έλξη (pull-based), ανακτώντας περιοδικά κρατήσεις από ενσωματωμένα εξωτερικά συστήματα.
Το ParkFlow.io είναι μια κεντρική πλατφόρμα (διαχειριστής καναλιών) που συνδέει φορείς εκμετάλλευσης χώρων στάθμευσης αεροδρομίων με διάφορα κανάλια πωλήσεων όπως ηλεκτρονικά ταξιδιωτικά πρακτορεία (OTAs), συναθροιστές, μεσίτες και B2C ιστότοπους. Λειτουργεί ως σύστημα ενδιάμεσου λογισμικού (middleware), απλοποιώντας τη διαχείριση κρατήσεων για χώρους στάθμευσης μέσω συγχρονισμού κρατήσεων, ενημερώσεων και ακυρώσεων από πολλαπλές πηγές σε ενιαία διεπαφή. Το ParkFlow βασίζεται κυρίως σε ένα μοντέλο ενσωμάτωσης βασισμένο σε έλξη (pull-based), όπου ανακτά περιοδικά δεδομένα κρατήσεων από τα APIs των συνεργατών.
Αυτός ο οδηγός απευθύνεται σε εξωτερικούς παρόχους υπηρεσιών (π.χ. OTAs, μεσίτες, αγορές) που επιθυμούν να ενσωματωθούν με το ParkFlow και να παρέχουν τις κρατήσεις τους μέσω API.
Το ParkFlow εκτελεί προγραμματισμένες εργασίες που ανακτούν νέες ή ενημερωμένες κρατήσεις από το API κάθε συνεργάτη. Αυτές οι εργασίες εκτελούνται συνήθως:
- Κάθε 2–10 λεπτά σε περιβάλλον παραγωγής
- Κάθε 15–30 λεπτά σε λειτουργία δοκιμής
Αυτό βοηθά να διασφαλιστεί ότι ο φορέας εκμετάλλευσης του χώρου στάθμευσης διαθέτει ενημερωμένες πληροφορίες σχετικά με τις επερχόμενες αφίξεις και τις απαιτήσεις εξυπηρέτησης.
- Ανάκτηση νέων επιβεβαιωμένων κρατήσεων
- Εντοπισμός ενημερωμένων στοιχείων πτήσης ή πελάτη
- Καταγραφή ακυρώσεων
- Διαχείριση αλλαγών τελευταίας στιγμής κοντά στην ώρα check-in
Εάν ο ιδιοκτήτης ενός χώρου στάθμευσης διαθέτει πολλαπλές προσφορές (π.χ., διαφορετικούς χώρους στάθμευσης ή προϊόντα) στο εξωτερικό σύστημα, το ParkFlow θα δημιουργήσει ξεχωριστή ενσωμάτωση για κάθε προσφορά, ώστε να διασφαλιστεί η ακριβής αντιστοίχιση, διαθεσιμότητα και συγχρονισμός τιμολόγησης.
Για ομαλή ενσωμάτωση, οι εξωτερικοί συνεργάτες πρέπει να εκθέτουν ένα δημόσιο REST API που υποστηρίζει τα εξής:
Το ParkFlow υποστηρίζει πολλαπλά σχήματα:
- Bearer Token: Authorization: Bearer <token>- Basic Auth: base64-κωδικοποιημένο user:password
- API Key: Μεταβιβάζεται στην κεφαλίδα (προτιμάται) ή σε παράμετρο ερωτήματος
Σημείωση: Τα διαπιστευτήρια αποθηκεύονται και διαχειρίζονται με ασφάλεια εντός της πλατφόρμας του ParkFlow.
Το ParkFlow απαιτεί μόνο ένα υποχρεωτικό endpoint:
GET /bookings – Αυτό το endpoint πρέπει να επιστρέφει μια λίστα με όλες τις κρατήσεις που έχουν δημιουργηθεί, ενημερωθεί ή ακυρωθεί από ένα συγκεκριμένο χρονικό σημείο. Το ParkFlow το χρησιμοποιεί για να συγχρονίζει αξιόπιστα δεδομένα από το εξωτερικό σύστημα.
Το αντικείμενο κράτησης πρέπει να περιέχει τις ακόλουθες πληροφορίες:
- Οι ημερομηνίες άφιξης και αναχώρησης πρέπει να είναι στην τοπική ζώνη ώρας
- Οι ημερομηνίες δημιουργίας και ενημέρωσης πρέπει να είναι σε UTC-0
- Τιμή, προπληρωμένο ποσό και νόμισμα
- Κατάσταση της κράτησης
- Αριθμός οχημάτων και πινακίδες κυκλοφορίας
- Αριθμός αναφοράς
Προαιρετικά endpoints:
- Κλείδωμα Διαθεσιμότητας
Επιτρέπει στο ParkFlow να ενημερώνει το εξωτερικό σύστημα όταν ένα συγκεκριμένο προϊόν στάθμευσης δεν είναι πλέον διαθέσιμο σε συγκεκριμένες ημερομηνίες.
Παράδειγμα:
POST /parkings/{id}/locks
Body: { "date": "2025-07-15", "reason": "full" }
- Ειδοποίηση Κατάστασης Κράτησης
Επιτρέπει στο ParkFlow να ειδοποιεί το εξωτερικό σύστημα για ακυρώσεις κρατήσεων ή μη εμφανίσεις (no-show) που κινούνται από τον χώρο στάθμευσης.
Παράδειγμα:
POST /bookings/{id}/cancel
Body: { "reason": "no_show" }
- Ενημερώσεις Τιμολόγησης
Δίνει τη δυνατότητα στο ParkFlow να αποστέλλει εποχικά ή βασικά δεδομένα τιμολόγησης για συγκεκριμένες προσφορές στάθμευσης.
Παράδειγμα:
POST /parkings/{id}/pricing
Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Διασφαλίστε ακριβείς και έγκαιρες αποκρίσεις
- Αποφύγετε την αποθήκευση cache παλαιών δεδομένων
- Επιτρέψτε στο ParkFlow να διαμορφώνει τη συχνότητα δημοσκόπησης
- Υποστηρίξτε σελιδοποίηση για μεγάλους όγκους κρατήσεων
- Παρέχετε περιβάλλον sandbox/δοκιμών με δεδομένα δοκιμής
- Όλα τα endpoints πρέπει να χρησιμοποιούν HTTPS
- Χρησιμοποιήστε ασφαλείς μεθόδους αυθεντικοποίησης (προτιμάται βασισμένη σε token)
- Περιορίστε την πρόσβαση βάσει λευκής λίστας IP (IP whitelisting) εάν είναι δυνατόν
- Αποφύγετε την αποθήκευση ευαίσθητων δεδομένων πελατών πέρα από ό,τι είναι απαραίτητο