Miten voimme auttaa?

ParkFlow.io on keskitetty alusta (kanavanhallintatyökalu), joka yhdistää lentokenttäpysäköintioperaattorit erilaisiin myyntikanaviin, kuten online-matkatoimistoihin (OTA:t), aggregaattoreihin, välittäjiin ja B2C-sivustoihin. Se toimii väliohjelmistona, joka yksinkertaistaa pysäköintialueiden varausten hallintaa synkronoimalla varaukset, päivitykset ja peruutukset useista lähteistä yhtenäiseen käyttöliittymään. ParkFlow nojaa ensisijaisesti hakuperusteiseen integraatiomalliin, jossa se hakee varaustiedot säännöllisesti kumppanien rajapinnoista.

Tämä opas on tarkoitettu ulkoisille palveluntarjoajille (esim. OTA:t, välittäjät, markkinapaikat), jotka haluavat integroitua ParkFlow'hun ja toimittaa varauksiaan rajapinnan kautta.

Toimintamalli

ParkFlow ajaa ajastettuja tehtäviä, jotka hakevat uudet tai päivitetyt varaukset kunkin kumppanin rajapinnasta. Nämä tehtävät suoritetaan tyypillisesti:

- Joka 2–10 minuutti tuotannossa
- Joka 15–30 minuutti testitilassa

Tämä auttaa varmistamaan, että pysäköintioperaattorilla on ajantasainen tieto tulevista saapumisista ja palveluvaatimuksista. 

Käyttötapaukset

- Uusien vahvistettujen varausten hakeminen
- Päivitettyjen lento- tai asiakastietojen tunnistaminen
- Peruutusten tallentaminen
- Viime hetken muutosten käsittely lähellä sisäänkirjautumisaikaa

Rajapintavaatimukset

Jos pysäköintialueen omistajalla on useita tarjouksia (esim. eri pysäköintialueet tai tuotteet) ulkoisessa järjestelmässä, ParkFlow luo kullekin tarjoukselle erillisen integraation tarkan kartoituksen, saatavuuden ja hinnoittelun synkronoinnin varmistamiseksi.

Sujuvan integraation varmistamiseksi ulkoisten kumppaneiden on tarjottava julkinen REST-rajapinta, joka tukee seuraavaa:

Todennus

ParkFlow tukee useita todennusmenetelmiä:

- Bearer Token: Authorization: Bearer <token>
- Basic Auth: base64-koodattu käyttäjätunnus:salasana
- API Key: Välitetään otsikossa (suositeltu) tai kyselyparametrina

Huomio: Tunnistetiedot tallennetaan ja hallitaan turvallisesti ParkFlow'n alustalla.

Päätepisteet

ParkFlow vaatii vain yhden pakollisen päätepisteen:

GET /bookings – Tämän päätepisteen on palautettava luettelo kaikista varauksista, jotka on luotu, päivitetty tai peruutettu tietyn ajankohdan jälkeen. ParkFlow käyttää tätä tietojen luotettavaan synkronointiin ulkoisesta järjestelmästä.

Varausobjektissa tulee olla seuraavat tiedot:

- Saapumis- ja lähtöpäivämäärät tulee ilmoittaa paikallisessa aikavyöhykkeessä

- Luonti- ja päivityspäivämäärät tulee ilmoittaa UTC-0-ajassa

- Hinta, ennakkomaksu ja valuutta

- Varauksen tila

- Ajoneuvojen lukumäärä ja rekisterikilvet

- Viitenumero

Valinnaiset päätepisteet:

- Saatavuuden lukitseminen

Mahdollistaa ParkFlow'n ilmoittamisen ulkoiselle järjestelmälle, kun tietty pysäköintituote ei ole enää saatavilla tietyille päivämäärille.

Esimerkki:

POST /parkings/{id}/locks

Body: { "date": "2025-07-15", "reason": "full" }

- Varauksen tilailmoitus

Mahdollistaa ParkFlow'n ilmoittamisen ulkoiselle järjestelmälle pysäköintialueen käynnistämistä varausten peruutuksista tai saapumatta jättämisistä.

Esimerkki:

POST /bookings/{id}/cancel

Body: { "reason": "no_show" }

- Hinnoittelupäivitykset

 Mahdollistaa ParkFlow'n lähettää kausiluonteisia tai perushinnoittelutietoja tietyille pysäköintitarjouksille.

 Esimerkki:

 POST /parkings/{id}/pricing

 Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }

Integraatiosuositukset

- Varmista tarkat ja oikea-aikaiset vastaukset

- Vältä vanhentuneiden tietojen välimuistittamista

- Salli ParkFlow'n määrittää kyselytaajuus

- Tue sivutusta suurille varausvolyymeille

- Tarjoa hiekkalaatikko-/testiympäristö testitiedoilla

Tietoturvavaatimukset

- Kaikkien päätepisteiden on käytettävä HTTPS:ää

- Käytä turvallisia todennusmenetelmiä (suosi tunnuspohjaisia)

- Rajoita pääsyä IP-sallintalistauksen avulla, jos mahdollista

- Vältä tallentamasta arkaluonteisia asiakastietoja enemmän kuin on tarpeen