ParkFlow.io är en channel manager för flygplatsparkeringar som kopplar samman flera bokningskällor (OTA:er, mäklare, webbplatser, aggregatorer) med parkeringsoperatörer. ParkFlow arbetar primärt med en pull-baserad modell och hämtar periodiskt bokningar från integrerade externa system.
ParkFlow.io är en centraliserad plattform (channel manager) som kopplar samman flygplatsparkeringsoperatörer med olika försäljningskanaler såsom onlineresebyråer (OTA:er), aggregatorer, mäklare och B2C-sajter. Den fungerar som ett middleware-system som förenklar bokningshanteringen för parkeringsanläggningar genom att synkronisera reservationer, uppdateringar och avbokningar från flera källor till ett enhetligt gränssnitt. ParkFlow förlitar sig primärt på en pull-baserad integrationsmodell där den periodiskt hämtar bokningsdata från partners API:er.
Den här guiden riktar sig till externa tjänsteleverantörer (t.ex. OTA:er, mäklare, marknadsplatser) som vill integrera med ParkFlow och leverera sina bokningar via ett API.
ParkFlow kör schemalagda jobb som hämtar nya eller uppdaterade bokningar från varje partners API. Dessa jobb körs vanligtvis:
- Var 2–10 minut i produktion
- Var 15–30 minut i testläge
Detta säkerställer att parkeringsoperatören har aktuell information om kommande ankomster och servicekrav.
- Hämtning av nya bekräftade reservationer
- Identifiering av uppdaterade flyg- eller kunduppgifter
- Registrering av avbokningar
- Hantering av sista-minuten-ändringar nära incheckningstid
Om en parkeringsägare har flera erbjudanden (t.ex. olika parkeringsanläggningar eller produkter) i det externa systemet kommer ParkFlow att upprätta en separat integration för varje erbjudande för att säkerställa korrekt mappning, tillgänglighet och prissynkronisering.
För en smidig integration måste externa partners exponera ett publikt REST API som stöder följande:
ParkFlow stöder flera metoder:
- Bearer Token: Authorization: Bearer <token>- Basic Auth: base64-kodat användarnamn:lösenord
- API Key: Skickas i header (rekommenderat) eller som frågeparameter
Obs! Inloggningsuppgifter lagras och hanteras säkert inom ParkFlows plattform.
ParkFlow kräver endast ett obligatoriskt endpoint:
GET /bookings – Det här endpointet måste returnera en lista över alla bokningar som har skapats, uppdaterats eller avbokats sedan en angiven tidpunkt. ParkFlow använder detta för att på ett tillförlitligt sätt synkronisera data från det externa systemet.
Bokningsobjektet bör innehålla följande information:
- Ankomst- och avresedatum ska anges i lokal tidszon
- Skapade och uppdaterade datum ska anges i UTC-0
- Pris, förskottsbetalt belopp och valuta
- Reservationens status
- Antal fordon och registreringsskyltar
- Referensnummer
Valfria endpoints:
- Tillgänglighetslåsning
Gör det möjligt för ParkFlow att informera det externa systemet när en specifik parkeringsprodukt inte längre är tillgänglig på vissa datum.
Exempel:
POST /parkings/{id}/locks
Body: { "date": "2025-07-15", "reason": "full" }
- Avisering om bokningsstatus
Gör det möjligt för ParkFlow att meddela det externa systemet om avbokningar eller uteblivna gäster som initierats av parkeringsanläggningen.
Exempel:
POST /bookings/{id}/cancel
Body: { "reason": "no_show" }
- Prisuppdateringar
Gör det möjligt för ParkFlow att skicka säsongs- eller basprisdata för specifika parkeringserbjudanden.
Exempel:
POST /parkings/{id}/pricing
Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Säkerställ korrekta och snabba svar
- Undvik att cacha inaktuell data
- Tillåt ParkFlow att konfigurera pollingsfrekvensen
- Stöd paginering för stora bokningsvolymer
- Tillhandahåll en sandbox-/testmiljö med testdata
- Alla endpoints måste använda HTTPS
- Använd säkra autentiseringsmetoder (tokenbaserade rekommenderas)
- Begränsa åtkomst via IP-vitlistning om möjligt
- Undvik att lagra känsliga kunduppgifter utöver vad som är nödvändigt