ParkFlow.io je channel manager za parkirališta na aerodromima koji povezuje više izvora rezervacija (OTA-ovi, brokeri, web stranice, agregatori) s operaterima parkirališta. ParkFlow primarno radi na modelu povlačenja podataka, periodički dohvaćajući rezervacije iz integriranih vanjskih sustava.
ParkFlow.io je centralizirana platforma (channel manager) koja povezuje operatere parkirališta na aerodromima s raznim prodajnim kanalima kao što su online putničke agencije (OTA-ovi), agregatori, brokeri i B2C stranice. Djeluje kao middleware sustav koji pojednostavljuje upravljanje rezervacijama za parkirališta sinkronizacijom rezervacija, ažuriranja i otkazivanja iz više izvora u jedinstven sučelje. ParkFlow se primarno oslanja na model integracije temeljen na povlačenju, pri čemu periodički dohvaća podatke o rezervacijama iz partnerskih API-ja.
Ovaj vodič namijenjen je vanjskim pružateljima usluga (npr. OTA-ovima, brokerima, tržišnim platformama) koji žele integrirati se s ParkFlow-om i dostavljati rezervacije putem API-ja.
ParkFlow izvodi planirane zadatke koji povlače nove ili ažurirane rezervacije iz API-ja svakog partnera. Ti se zadaci tipično izvršavaju:
- Svakih 2–10 minuta u produkciji
- Svakih 15–30 minuta u testnom načinu rada
To pomaže osigurati da operater parkirališta ima ažurirane informacije o nadolazećim dolascima i zahtjevima za usluge.
- Dohvaćanje novih potvrđenih rezervacija
- Otkrivanje ažuriranih podataka o letu ili korisniku
- Bilježenje otkazivanja
- Upravljanje promjenama u zadnjem trenutku blizu vremena prijave
Ako vlasnik parkirališta ima više ponuda (npr. različita parkirališta ili proizvode) u vanjskom sustavu, ParkFlow će uspostaviti zasebnu integraciju za svaku ponudu kako bi osigurao točno mapiranje, dostupnost i sinkronizaciju cijena.
Za nesmetanu integraciju, vanjski partneri moraju izložiti javni REST API koji podržava sljedeće:
ParkFlow podržava više shema:
- Bearer Token: Authorization: Bearer <token>- Basic Auth: korisničko ime i lozinka kodirani u base64
- API Key: Prosljeđuje se u zaglavlju (preporučeno) ili kao parametar upita
Napomena: Vjerodajnice se sigurno pohranjuju i upravljaju unutar ParkFlow platforme.
ParkFlow zahtijeva samo jednu obaveznu krajnju točku:
GET /bookings – Ova krajnja točka mora vratiti popis svih rezervacija koje su stvorene, ažurirane ili otkazane od određenog trenutka u vremenu. ParkFlow to koristi za pouzdanu sinkronizaciju podataka iz vanjskog sustava.
Objekt rezervacije trebao bi sadržavati sljedeće informacije:
- Datumi dolaska i odlaska trebaju biti u lokalnoj vremenskoj zoni
- Datumi kreiranja i ažuriranja trebaju biti u UTC-0
- Cijena, unaprijed plaćeni iznos i valuta
- Status rezervacije
- Broj vozila i registracijske oznake
- Referentni broj
Opcionalne krajnje točke:
- Zaključavanje dostupnosti
Omogućuje ParkFlow-u da obavijesti vanjski sustav kada određeni parkirni proizvod više nije dostupan za određene datume.
Primjer:
POST /parkings/{id}/locks
Body: { "date": "2025-07-15", "reason": "full" }
- Obavijest o statusu rezervacije
Omogućuje ParkFlow-u da obavijesti vanjski sustav o otkazivanjima rezervacija ili nedolascima koje je iniciralo parkiralište.
Primjer:
POST /bookings/{id}/cancel
Body: { "reason": "no_show" }
- Ažuriranje cijena
Omogućuje ParkFlow-u slanje sezonskih ili osnovnih podataka o cijenama za određene parkirne ponude.
Primjer:
POST /parkings/{id}/pricing
Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Osigurajte točne i pravovremene odgovore
- Izbjegavajte predmemoriranje zastarjelih podataka
- Dopustite ParkFlow-u konfiguriranje učestalosti dohvaćanja
- Podržite paginaciju za velike količine rezervacija
- Osigurajte okruženje za testiranje s testnim podacima
- Sve krajnje točke moraju koristiti HTTPS
- Koristite sigurne metode autentikacije (prednost imaju metode temeljene na tokenu)
- Ograničite pristup na temelju IP whitelistinga ako je moguće
- Izbjegavajte pohranu osjetljivih korisničkih podataka izvan onoga što je nužno