Jak vám můžeme pomoci?

ParkFlow.io je centralizovaná platforma (channel manager), která propojuje provozovatele letištních parkovišť s různými prodejními kanály, jako jsou online cestovní agentury (OTA), agregátory, zprostředkovatelé a B2C weby. Funguje jako middleware systém, který zjednodušuje správu rezervací pro parkoviště synchronizací rezervací, aktualizací a stornování z více zdrojů do jednotného rozhraní. ParkFlow primárně využívá pull-based integrační model, kdy pravidelně načítá data o rezervacích z partnerských API.

Tento průvodce je určen pro externí poskytovatele služeb (např. OTA, zprostředkovatelé, tržiště), kteří chtějí integrovat s ParkFlow a poskytovat své rezervace prostřednictvím API.

Provozní model

ParkFlow spouští naplánované úlohy, které stahují nové nebo aktualizované rezervace z API každého partnera. Tyto úlohy se typicky spouštějí:

- Každé 2–10 minut v produkčním prostředí
- Každých 15–30 minut v testovacím režimu

Tím je zajištěno, že provozovatel parkoviště má aktuální informace o nadcházejících příjezdech a požadavcích na služby. 

Pokryté případy použití

- Načítání nových potvrzených rezervací
- Zjišťování aktualizací letových nebo zákaznických údajů
- Zachycení stornování
- Zpracování změn na poslední chvíli v blízkosti času odbavení

Požadavky na API

Pokud má vlastník parkoviště v externím systému více nabídek (např. různá parkoviště nebo produkty), ParkFlow vytvoří samostatnou integraci pro každou nabídku, aby byla zajištěna přesná synchronizace mapování, dostupnosti a cen.

Pro hladkou integraci musí externí partneři zpřístupnit veřejné REST API, které podporuje následující:

Autentizace

ParkFlow podporuje více schémat:

- Bearer Token: Authorization: Bearer <token>
- Basic Auth: uživatel:heslo zakódované v base64
- API Key: Předávané v hlavičce (preferováno) nebo jako parametr dotazu

Poznámka: Přihlašovací údaje jsou bezpečně uloženy a spravovány v rámci platformy ParkFlow.

Endpointy

ParkFlow vyžaduje pouze jeden povinný endpoint:

GET /bookings – Tento endpoint musí vrátit seznam všech rezervací, které byly vytvořeny, aktualizovány nebo stornovány od určitého okamžiku v čase. ParkFlow jej používá ke spolehlivé synchronizaci dat z externího systému.

Objekt rezervace by měl obsahovat následující informace:

- Data příjezdu a odjezdu by měla být v místním časovém pásmu

- Data vytvoření a aktualizace by měla být v UTC-0

- Cena, předplacená částka a měna

- Stav rezervace

- Počet vozidel a registrační značky

- Referenční číslo

Volitelné endpointy:

- Uzamčení dostupnosti

Umožňuje ParkFlow informovat externí systém, když konkrétní parkovací produkt není v určitých datech k dispozici.

Příklad:

POST /parkings/{id}/locks

Tělo: { "date": "2025-07-15", "reason": "full" }

- Oznámení o stavu rezervace

Umožňuje ParkFlow informovat externí systém o stornování rezervací nebo nedostavení se, iniciovaných parkovištěm.

Příklad:

POST /bookings/{id}/cancel

Tělo: { "reason": "no_show" }

- Aktualizace cen

 Umožňuje ParkFlow odesílat sezónní nebo základní cenová data pro konkrétní parkovací nabídky.

 Příklad:

 POST /parkings/{id}/pricing

 Tělo: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }

Doporučení pro integraci

- Zajistěte přesné a včasné odpovědi

- Vyhněte se ukládání zastaralých dat do mezipaměti

- Umožněte ParkFlow konfigurovat frekvenci dotazování

- Podporujte stránkování pro velké objemy rezervací

- Poskytněte sandbox/testovací prostředí s testovacími daty

Bezpečnostní požadavky

- Všechny endpointy musí používat HTTPS

- Používejte bezpečné metody autentizace (preferujte tokenovou autentizaci)

- Omezte přístup pomocí whitelistingu IP adres, pokud je to možné

- Neuchovávejte citlivé zákaznické údaje nad rámec toho, co je nezbytné