ParkFlow.io este un manager de canale pentru parcările aeroportuare, conectând multiple surse de rezervare (OTA-uri, brokeri, site-uri web, agregatori) cu operatorii de parcare. ParkFlow funcționează în principal pe un model bazat pe interogare periodică (pull), preluând rezervările din sistemele externe integrate la intervale regulate.
ParkFlow.io este o platformă centralizată (manager de canale) care conectează operatorii de parcare aeroportuară cu diverse canale de vânzare precum agențiile de turism online (OTA-uri), agregatori, brokeri și site-uri B2C. Acționează ca un sistem middleware, simplificând gestionarea rezervărilor pentru parcări prin sincronizarea rezervărilor, actualizărilor și anulărilor din multiple surse într-o interfață unificată. ParkFlow se bazează în principal pe un model de integrare bazat pe interogare periodică (pull), prin care preia periodic datele despre rezervări din API-urile partenerilor.
Acest ghid este destinat furnizorilor externi de servicii (de ex. OTA-uri, brokeri, piețe de servicii) care doresc să se integreze cu ParkFlow și să transmită rezervările lor printr-un API.
ParkFlow rulează sarcini programate care preiau rezervări noi sau actualizate din API-ul fiecărui partener. Aceste sarcini se execută de obicei:
- La fiecare 2–10 minute în producție
- La fiecare 15–30 minute în modul de testare
Acest lucru ajută la asigurarea faptului că operatorul de parcare dispune de informații actualizate despre sosirile viitoare și cerințele de serviciu.
- Preluarea rezervărilor noi confirmate
- Detectarea actualizărilor detaliilor de zbor sau ale clientului
- Captarea anulărilor
- Gestionarea modificărilor de ultimă oră aproape de momentul check-in-ului
Dacă un proprietar de parcare are mai multe oferte (de ex., parcări sau produse diferite) în sistemul extern, ParkFlow va stabili o integrare separată pentru fiecare ofertă, pentru a asigura maparea corectă, sincronizarea disponibilității și a prețurilor.
Pentru o integrare fără probleme, partenerii externi trebuie să expună un API REST public care să suporte următoarele:
ParkFlow suportă mai multe scheme:
- Bearer Token: Authorization: Bearer <token>- Basic Auth: utilizator:parolă codificate în base64
- API Key: Transmisă în antet (preferată) sau ca parametru de interogare
Notă: Acreditările sunt stocate și gestionate în siguranță în cadrul platformei ParkFlow.
ParkFlow necesită un singur endpoint obligatoriu:
GET /bookings – Acest endpoint trebuie să returneze o listă cu toate rezervările care au fost create, actualizate sau anulate începând de la un moment specificat în timp. ParkFlow folosește aceasta pentru a sincroniza datele în mod fiabil din sistemul extern.
Obiectul de rezervare trebuie să conțină următoarele informații:
- Datele de sosire și plecare trebuie să fie în fusul orar local
- Datele de creare și actualizare trebuie să fie în UTC-0
- Prețul, suma prepltită și moneda
- Statusul rezervării
- Numărul de vehicule și plăcuțele de înmatriculare
- Numărul de referință
Endpoint-uri opționale:
- Blocarea Disponibilității
Permite ParkFlow să informeze sistemul extern când un anumit produs de parcare nu mai este disponibil în anumite date.
Exemplu:
POST /parkings/{id}/locks
Body: { "date": "2025-07-15", "reason": "full" }
- Notificare Status Rezervare
Permite ParkFlow să notifice sistemul extern despre anulările de rezervări sau neprezentările inițiate de parcarea auto.
Exemplu:
POST /bookings/{id}/cancel
Body: { "reason": "no_show" }
- Actualizări de Prețuri
Permite ParkFlow să trimită date de prețuri sezoniere sau de bază pentru oferte specifice de parcare.
Exemplu:
POST /parkings/{id}/pricing
Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Asigurați răspunsuri precise și la timp
- Evitați stocarea în cache a datelor învechite
- Permiteți ParkFlow să configureze frecvența de interogare
- Suportați paginarea pentru volume mari de rezervări
- Furnizați un mediu sandbox/de testare cu date de test
- Toate endpoint-urile trebuie să folosească HTTPS
- Utilizați metode de autentificare securizate (preferate cele bazate pe token)
- Limitați accesul pe baza listei albe de IP-uri, dacă este posibil
- Evitați stocarea datelor sensibile ale clienților dincolo de ceea ce este necesar