A ParkFlow.io egy csatornakezető (channel manager) repülőtéri parkolók számára, amely több foglalási forrást (OTA-k, közvetítők, weboldalak, aggregátorok) köt össze parkolóüzemeltetőkkel. A ParkFlow elsősorban lekéréses (pull-alapú) modellben működik, rendszeresen lekérve a foglalásokat az integrált külső rendszerekből.
A ParkFlow.io egy centralizált platform (csatornakezető), amely összeköti a repülőtéri parkolóüzemeltetőket különböző értékesítési csatornákkal, mint például online utazási irodák (OTA-k), aggregátorok, közvetítők és B2C oldalak. Köztes rendszerként működik, egyszerűsítve a parkolók foglaláskezelését azáltal, hogy több forrásból szinkronizálja a foglalásokat, módosításokat és lemondásokat egyetlen egységes felületre. A ParkFlow elsősorban lekéréses (pull-alapú) integrációs modellre támaszkodik, amelynek keretében rendszeresen lekéri a foglalási adatokat a partnerek API-jaiból.
Ez az útmutató külső szolgáltatók (pl. OTA-k, közvetítők, piacterek) számára készült, amelyek integrálni szeretnének a ParkFlow-val, és API-n keresztül szeretnék biztosítani foglalásaikat.
A ParkFlow ütemezett feladatokat futtat, amelyek lekérik az új vagy frissített foglalásokat az egyes partnerek API-jaiból. Ezek a feladatok jellemzően az alábbi időközönként futnak:
- Éles üzemben minden 2–10 percben
- Tesztelési módban minden 15–30 percben
Ez segít biztosítani, hogy a parkolóüzemeltetőnek naprakész információi legyenek a közelgő érkezésekről és a szolgáltatási igényekről.
- Új, megerősített foglalások lekérése
- Módosított járat- vagy ügyfélada tok észlelése
- Lemondások rögzítése
- Utolsó pillanatban, a bejelentkezési idő közelében bekövetkező változások kezelése
Ha egy parkolótulajdonosnak több ajánlata van a külső rendszerben (pl. különböző parkolók vagy termékek), a ParkFlow minden egyes ajánlathoz külön integrációt hoz létre a pontos leképezés, az elérhetőség és az árszinkronizáció biztosítása érdekében.
A zökkenőmentes integráció érdekében a külső partnereknek egy nyilvános REST API-t kell elérhetővé tenniük, amely az alábbiakat támogatja:
A ParkFlow több sémát is támogat:
- Bearer Token: Authorization: Bearer <token>- Basic Auth: base64-kódolt felhasználónév:jelszó
- API Key: Fejlécben (előnyben részesített) vagy lekérdezési paraméterként átadva
Megjegyzés: A hitelesítő adatokat a ParkFlow platformja biztonságosan tárolja és kezeli.
A ParkFlow egyetlen kötelező végpontot igényel:
GET /bookings – Ez a végpont egy olyan foglaláslistát kell, hogy visszaadjon, amelyek egy megadott időpont óta létrejöttek, frissültek vagy lemondásra kerültek. A ParkFlow ezt használja az adatok megbízható szinkronizálásához a külső rendszerből.
A foglalási objektumnak az alábbi információkat kell tartalmaznia:
- Az érkezési és indulási dátumoknak helyi időzónában kell lenniük
- A létrehozási és frissítési dátumoknak UTC-0 szerintinek kell lenniük
- Ár, előre fizetett összeg és pénznem
- A foglalás státusza
- Járművek száma és rendszámok
- Referenciaszám
Opcionális végpontok:
- Elérhetőség zárolása
Lehetővé teszi, hogy a ParkFlow értesítse a külső rendszert, ha egy adott parkolási termék bizonyos dátumokon már nem elérhető.
Példa:
POST /parkings/{id}/locks
Törzs: { "date": "2025-07-15", "reason": "full" }
- Foglalási státusz értesítés
Lehetővé teszi, hogy a ParkFlow értesítse a külső rendszert a parkoló által kezdeményezett foglaláslemondásokról vagy meg nem jelenésekről.
Példa:
POST /bookings/{id}/cancel
Törzs: { "reason": "no_show" }
- Árfrissítések
Lehetővé teszi a ParkFlow számára, hogy szezonális vagy alap áradata kat küldjön adott parkolási ajánlatokhoz.
Példa:
POST /parkings/{id}/pricing
Törzs: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Biztosítson pontos és időszerű válaszokat
- Kerülje az elavult adatok gyorsítótárazását
- Tegye lehetővé a ParkFlow számára a lekérdezési gyakoriság beállítását
- Támogassa a lapozást (pagination) nagy foglalásmennyiség esetén
- Biztosítson tesztelési környezetet (sandbox) tesztadatokkal
- Minden végpontnak HTTPS-t kell használnia
- Biztonságos hitelesítési módszereket alkalmazzon (token-alapú előnyben részesítve)
- Lehetőség szerint korlátozza a hozzáférést IP-engedélyezési lista alapján
- Kerülje az érzékeny ügyféladatok szükségesnél hosszabb ideig történő tárolását