ParkFlow.io er en kanalbehandler for flyplassparkering, som kobler sammen flere bookingkilder (OTA-er, meglere, nettsteder, aggregatorer) med parkeringsoperatører. ParkFlow opererer primært etter en pull-basert modell der bookinger hentes periodisk fra integrerte eksterne systemer.
ParkFlow.io er en sentralisert plattform (kanalbehandler) som kobler flyplassparkeringsoperatører sammen med ulike salgskanaler som nettbaserte reisebyråer (OTA-er), aggregatorer, meglere og B2C-nettsteder. Den fungerer som et mellomvaresystem som forenkler bookingbehandling for parkeringsanlegg ved å synkronisere reservasjoner, oppdateringer og kanselloringer fra flere kilder til ett samlet grensesnitt. ParkFlow benytter primært en pull-basert integrasjonsmodell, der den periodisk henter bookingdata fra partner-API-er.
Denne guiden er for eksterne tjenesteleverandører (f.eks. OTA-er, meglere, markedsplasser) som ønsker å integrere med ParkFlow og levere bookinger via et API.
ParkFlow kjører planlagte jobber som henter nye eller oppdaterte bookinger fra hver partners API. Disse jobbene kjøres vanligvis:
- Hvert 2–10 minutt i produksjon
- Hvert 15–30 minutt i testmodus
Dette bidrar til å sikre at parkeringsoperatøren har oppdatert informasjon om kommende ankomster og servicebehov.
- Henting av nye bekreftede reservasjoner
- Registrering av oppdaterte fly- eller kundeopplysninger
- Fange opp kanselloringer
- Håndtere siste-minutt-endringer nær innsjekktidspunktet
Hvis en parkeringsanleggseier har flere tilbud (f.eks. ulike parkeringsanlegg eller produkter) i det eksterne systemet, vil ParkFlow opprette en separat integrasjon for hvert tilbud for å sikre nøyaktig kartlegging, tilgjengelighet og prissynkronisering.
For å integrere smidig må eksterne partnere eksponere et offentlig REST API som støtter følgende:
ParkFlow støtter flere metoder:
- Bearer Token: Authorization: Bearer <token>- Basic Auth: base64-kodet bruker:passord
- API Key: Sendes i header (foretrukket) eller som spørringsparameter
Merk: Legitimasjon lagres sikkert og administreres innenfor ParkFlow sin plattform.
ParkFlow krever kun ett obligatorisk endepunkt:
GET /bookings – Dette endepunktet må returnere en liste over alle bookinger som er opprettet, oppdatert eller kansellert siden et angitt tidspunkt. ParkFlow bruker dette til å synkronisere data pålitelig fra det eksterne systemet.
Bookingobjektet bør inneholde følgende informasjon:
- Ankomst- og avreisedatoer skal være i lokal tidssone
- Opprettede og oppdaterte datoer skal være i UTC-0
- Pris, forhåndsbetalt beløp og valuta
- Status for reservasjonen
- Antall kjøretøy og registreringsnummer
- Referansenummer
Valgfrie endepunkter:
- Tilgjengelighetslåsing
Gjør det mulig for ParkFlow å informere det eksterne systemet når et bestemt parkeringsprodukt ikke lenger er tilgjengelig på bestemte datoer.
Eksempel:
POST /parkings/{id}/locks
Body: { "date": "2025-07-15", "reason": "full" }
- Varsling om bookingstatus
Gjør det mulig for ParkFlow å varsle det eksterne systemet om bookingkanselloringer eller uteblivelser initiert av parkeringsanlegget.
Eksempel:
POST /bookings/{id}/cancel
Body: { "reason": "no_show" }
- Prisoppdateringer
Gjør det mulig for ParkFlow å sende sesong- eller grunnprisdata for spesifikke parkeringstilbud.
Eksempel:
POST /parkings/{id}/pricing
Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Sørg for nøyaktige og raske svar
- Unngå hurtigbufring av utdaterte data
- Tillat ParkFlow å konfigurere pollingsfrekvens
- Støtt paginering for store bookingvolumer
- Tilby et sandkasse-/testmiljø med testdata
- Alle endepunkter må bruke HTTPS
- Bruk sikre autentiseringsmetoder (foretrekk tokenbasert)
- Begrens tilgang basert på IP-hvitelisting der det er mulig
- Unngå å lagre sensitiv kundeinformasjon utover det som er nødvendig