ParkFlow.io je upravljavec kanalov za parkirišča na letališčih, ki povezuje več virov rezervacij (OTA, posredniki, spletna mesta, agregatorji) s parkirnimi operaterji. ParkFlow deluje predvsem po modelu povpraševanja (pull), pri katerem periodično pridobiva rezervacije iz integriranih zunanjih sistemov.
ParkFlow.io je centralizirana platforma (upravljavec kanalov), ki povezuje operaterje letaliških parkirišč z različnimi prodajnimi kanali, kot so spletne turistične agencije (OTA), agregatorji, posredniki in spletna mesta B2C. Deluje kot vmesniški sistem, ki parkirnim hišam poenostavlja upravljanje rezervacij z usklajevanjem rezervacij, posodobitev in odpovedi iz več virov v enoten vmesnik. ParkFlow se v glavnem opira na integracijski model pull, pri katerem periodično pridobiva podatke o rezervacijah iz API-jev partnerjev.
Ta vodnik je namenjen zunanjim ponudnikom storitev (npr. OTA, posrednikom, tržnicam), ki se želijo integrirati s ParkFlow in prek API-ja posredovati svoje rezervacije.
ParkFlow izvaja načrtovana opravila, ki pridobivajo nove ali posodobljene rezervacije iz API-ja vsakega partnerja. Ta opravila se običajno izvajajo:
- Vsakih 2–10 minut v produkciji
- Vsakih 15–30 minut v testnem načinu
S tem se zagotovi, da ima parkirni operater ažurne informacije o prihajajočih prihodih in zahtevah glede storitev.
- Pridobivanje novih potrjenih rezervacij
- Zaznavanje posodobljenih podatkov o letu ali stranki
- Beleženje odpovedi
- Obravnava sprememb v zadnjem trenutku pred prijavo
Če ima lastnik parkirišča v zunanjem sistemu več ponudb (npr. različna parkirišča ali produkte), bo ParkFlow vzpostavil ločeno integracijo za vsako ponudbo, da se zagotovi natančno preslikavanje, razpoložljivost in usklajevanje cen.
Za nemoteno integracijo morajo zunanji partnerji izpostaviti javni REST API, ki podpira naslednje:
ParkFlow podpira več shem:
- Bearer žeton: Authorization: Bearer <token>- Basic Auth: base64-kodiran user:password
- API ključ: Posredovan v glavi (priporočeno) ali kot parametr poizvedbe
Opomba: Poverilnice so varno shranjene in upravljane znotraj platforme ParkFlow.
ParkFlow zahteva samo eno obvezno končno točko:
GET /bookings – Ta končna točka mora vrniti seznam vseh rezervacij, ki so bile ustvarjene, posodobljene ali preklicane od določenega trenutka v preteklosti. ParkFlow to uporablja za zanesljivo usklajevanje podatkov iz zunanjega sistema.
Objekt rezervacije mora vsebovati naslednje informacije:
- Datuma prihoda in odhoda morata biti v lokalnem časovnem pasu
- Datuma ustvarjanja in posodobitve morata biti v UTC-0
- Cena, vnaprej plačan znesek in valuta
- Status rezervacije
- Število vozil in registrske tablice
- Referenčna številka
Neobvezne končne točke:
- Zaklepanje razpoložljivosti
Omogoča ParkFlow, da obvesti zunanji sistem, ko določen parkirni produkt v določenih datumih ni več na voljo.
Primer:
POST /parkings/{id}/locks
Telo: { "date": "2025-07-15", "reason": "full" }
- Obvestilo o statusu rezervacije
Omogoča ParkFlow, da obvesti zunanji sistem o odpovedih rezervacij ali izostankih, ki jih sproži parkirišče.
Primer:
POST /bookings/{id}/cancel
Telo: { "reason": "no_show" }
- Posodobitve cen
Omogoča ParkFlow pošiljanje sezonskih ali osnovnih cenovnih podatkov za določene parkirne ponudbe.
Primer:
POST /parkings/{id}/pricing
Telo: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Zagotovite natančne in pravočasne odgovore
- Izogibajte se predpomnjenju zastarelih podatkov
- Dovolite ParkFlow konfiguracijo pogostosti poizvedovanja
- Podprite paginacijo za velike količine rezervacij
- Zagotovite okolje peskovnika/testiranja s testnimi podatki
- Vse končne točke morajo uporabljati HTTPS
- Uporabite varne metode avtentikacije (priporočena je metoda na osnovi žetonov)
- Po možnosti omejite dostop z dovoljenjem določenih IP-naslovov
- Izogibajte se shranjevanju občutljivih podatkov o strankah v obsegu, ki presega nujno potrebno