ParkFlow.io je channel manager pre letiskové parkoviská, ktorý prepája viacero zdrojov rezervácií (OTA, brokeri, webové stránky, agregátory) s prevádzkovateľmi parkovísk. ParkFlow primárne funguje na modeli založenom na sťahovaní (pull), kde pravidelne načítava rezervácie z integrovaných externých systémov.
ParkFlow.io je centralizovaná platforma (channel manager), ktorá prepája prevádzkovateľov letiskových parkovísk s rôznymi predajnými kanálmi, ako sú online cestovné agentúry (OTA), agregátory, brokeri a B2C stránky. Funguje ako middlewarový systém, ktorý zjednodušuje správu rezervácií pre parkoviská synchronizáciou rezervácií, aktualizácií a stornovaní z viacerých zdrojov do jednotného rozhrania. ParkFlow sa primárne spolieha na integračný model založený na sťahovaní (pull), kde pravidelne načítava údaje o rezerváciách z partnerských API.
Táto príručka je určená pre externých poskytovateľov služieb (napr. OTA, brokeri, marketplace platformy), ktorí chcú integrovať s ParkFlow a poskytovať svoje rezervácie prostredníctvom API.
ParkFlow spúšťa plánované úlohy, ktoré sťahujú nové alebo aktualizované rezervácie z API každého partnera. Tieto úlohy sa zvyčajne vykonávajú:
- Každé 2–10 minút v produkcii
- Každých 15–30 minút v testovacom režime
Tým sa zabezpečuje, že prevádzkovateľ parkoviska má aktuálne informácie o nadchádzajúcich príchodoch a požiadavkách na služby.
- Načítavanie nových potvrdených rezervácií
- Detekcia aktualizovaných údajov o lete alebo zákazníkovi
- Zachytávanie stornovaní
- Spracovanie zmien na poslednú chvíľu pred časom odhlásenia
Ak má vlastník parkoviska viacero ponúk (napr. rôzne parkoviská alebo produkty) v externom systéme, ParkFlow vytvorí samostatnú integráciu pre každú ponuku, aby bolo zaistené presné mapovanie, synchronizácia dostupnosti a cien.
Pre bezproblémovú integráciu musia externí partneri sprístupniť verejné REST API, ktoré podporuje nasledovné:
ParkFlow podporuje viacero schém:
- Bearer Token: Authorization: Bearer <token>- Basic Auth: base64-kódovaný user:password
- API Key: Odoslaný v hlavičke (preferované) alebo ako parameter dotazu
Poznámka: Prihlasovacie údaje sú bezpečne uložené a spravované v rámci platformy ParkFlow.
ParkFlow vyžaduje iba jeden povinný endpoint:
GET /bookings – Tento endpoint musí vrátiť zoznam všetkých rezervácií, ktoré boli vytvorené, aktualizované alebo stornované od určeného časového bodu. ParkFlow to využíva na spoľahlivú synchronizáciu údajov z externého systému.
Objekt rezervácie by mal obsahovať nasledujúce informácie:
- Dátumy príchodu a odchodu by mali byť v miestnom časovom pásme
- Dátumy vytvorenia a aktualizácie by mali byť v UTC-0
- Cena, vopred zaplatená suma a mena
- Stav rezervácie
- Počet vozidiel a evidenčné čísla
- Referenčné číslo
Voliteľné endpointy:
- Blokovanie dostupnosti
Umožňuje ParkFlow informovať externý systém, keď konkrétny parkovací produkt nie je dostupný v určitých dátumoch.
Príklad:
POST /parkings/{id}/locks
Body: { "date": "2025-07-15", "reason": "full" }
- Notifikácia o stave rezervácie
Umožňuje ParkFlow notifikovať externý systém o stornovaní rezervácií alebo neprítomnosti zákazníka (no-show) iniciovaných parkoviskom.
Príklad:
POST /bookings/{id}/cancel
Body: { "reason": "no_show" }
- Aktualizácie cien
Umožňuje ParkFlow odosielať sezónne alebo základné cenové údaje pre konkrétne parkovacie ponuky.
Príklad:
POST /parkings/{id}/pricing
Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Zabezpečte presné a včasné odpovede
- Vyhnite sa cachovaniu zastaraných údajov
- Umožnite ParkFlow konfigurovať frekvenciu pollovania
- Podporujte stránkovanie pre veľké objemy rezervácií
- Poskytnite sandbox/testovacie prostredie s testovacími dátami
- Všetky endpointy musia používať HTTPS
- Používajte bezpečné metódy autentifikácie (uprednostňujte tokenovú autentifikáciu)
- Obmedzte prístup pomocou whitelistovania IP adries, ak je to možné
- Nevuchovávajte citlivé zákaznícke údaje nad rámec toho, čo je nevyhnutné