ParkFlow.io is een channel manager voor luchthavenparkeerplaatsen die meerdere boekingsbronnen (OTA's, makelaars, websites, aggregators) verbindt met parkeeroperators. ParkFlow werkt voornamelijk op basis van een pull-model, waarbij periodiek boekingen worden opgehaald uit geïntegreerde externe systemen.
ParkFlow.io is een gecentraliseerd platform (channel manager) dat luchthavenparkeeroperators verbindt met verschillende verkoopkanalen zoals online reisbureaus (OTA's), aggregators, makelaars en B2C-sites. Het fungeert als een middlewaresysteem dat het boekingsbeheer voor parkeerterreinen vereenvoudigt door reserveringen, updates en annuleringen uit meerdere bronnen te synchroniseren in één uniforme interface. ParkFlow maakt voornamelijk gebruik van een pull-gebaseerd integratiemodel, waarbij het periodiek boekingsgegevens ophaalt bij partner-API's.
Deze handleiding is bestemd voor externe dienstverleners (bijv. OTA's, makelaars, marktplaatsen) die willen integreren met ParkFlow en hun boekingen via een API willen aanleveren.
ParkFlow voert geplande taken uit die nieuwe of bijgewerkte boekingen ophalen van de API van elke partner. Deze taken worden doorgaans uitgevoerd:
- Elke 2–10 minuten in productie
- Elke 15–30 minuten in testmodus
Dit zorgt ervoor dat de parkeeroperator actuele informatie heeft over aankomende aankomsten en servicebehoeften.
- Ophalen van nieuwe bevestigde reserveringen
- Detecteren van bijgewerkte vlucht- of klantgegevens
- Vastleggen van annuleringen
- Verwerken van last-minute wijzigingen vlak voor inchecktijd
Als een parkeereigenaar meerdere aanbiedingen heeft (bijv. verschillende parkeerterreinen of producten) in het externe systeem, zal ParkFlow voor elk aanbod een afzonderlijke integratie opzetten om een nauwkeurige koppeling, beschikbaarheid en prijssynchronisatie te garanderen.
Voor een soepele integratie moeten externe partners een publieke REST API beschikbaar stellen die het volgende ondersteunt:
ParkFlow ondersteunt meerdere methoden:
- Bearer Token: Authorization: Bearer <token>- Basisauthenticatie: base64-gecodeerd gebruiker:wachtwoord
- API-sleutel: Doorgegeven in header (voorkeur) of queryparameter
Opmerking: Inloggegevens worden veilig opgeslagen en beheerd binnen het platform van ParkFlow.
ParkFlow vereist slechts één verplicht eindpunt:
GET /bookings – Dit eindpunt moet een lijst retourneren van alle boekingen die zijn aangemaakt, bijgewerkt of geannuleerd sinds een opgegeven tijdstip. ParkFlow gebruikt dit om gegevens betrouwbaar te synchroniseren vanuit het externe systeem.
Het boekingsobject moet de volgende informatie bevatten:
- Aankomst- en vertrekdatums dienen in de lokale tijdzone te zijn
- Aanmaak- en bijwerkdatums dienen in UTC-0 te zijn
- Prijs, vooruitbetaald bedrag en valuta
- Status van de reservering
- Aantal voertuigen en kentekens
- Referentienummer
Optionele eindpunten:
- Beschikbaarheidsvergrendeling
Stelt ParkFlow in staat het externe systeem te informeren wanneer een specifiek parkeerproduct niet langer beschikbaar is op bepaalde datums.
Voorbeeld:
POST /parkings/{id}/locks
Body: { "date": "2025-07-15", "reason": "full" }
- Boekingsstatus Notificatie
Stelt ParkFlow in staat het externe systeem op de hoogte te stellen van boekingsannuleringen of no-shows die door het parkeerterrein zijn geïnitieerd.
Voorbeeld:
POST /bookings/{id}/cancel
Body: { "reason": "no_show" }
- Prijsupdates
Stelt ParkFlow in staat seizoens- of basisprijsgegevens te sturen voor specifieke parkeeraanbiedingen.
Voorbeeld:
POST /parkings/{id}/pricing
Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Zorg voor nauwkeurige en tijdige antwoorden
- Vermijd het cachen van verouderde gegevens
- Sta ParkFlow toe de pollingfrequentie in te stellen
- Ondersteuning paginering voor grote boekingsvolumes
- Bied een sandbox-/testomgeving met testgegevens aan
- Alle eindpunten moeten HTTPS gebruiken
- Gebruik veilige authenticatiemethoden (voorkeur voor tokengebaseerd)
- Beperk toegang op basis van IP-whitelisting indien mogelijk
- Vermijd het opslaan van gevoelige klantgegevens voorbij wat noodzakelijk is