Ghid de Integrare Externă
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.
Model de Funcționare
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.
Cazuri de Utilizare Acoperite
- 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
Cerințe API
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:
Autentificare
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.
Endpoint-uri
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, ... }
Recomandări de Integrare
- 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
Cerințe de Securitate
- 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