Jak możemy Ci pomóc?

ParkFlow.io to scentralizowana platforma (menedżer kanałów), która łączy operatorów parkingów lotniskowych z różnymi kanałami sprzedaży, takimi jak internetowe agencje podróży (OTA), agregatory, brokerzy i witryny B2C. Pełni rolę systemu pośredniczącego (middleware), upraszczając zarządzanie rezerwacjami dla parkingów poprzez synchronizację rezerwacji, aktualizacji i anulowań z wielu źródeł w jednym ujednoliconym interfejsie. ParkFlow opiera się przede wszystkim na modelu integracji opartym na pobieraniu danych (pull), w którym okresowo pobiera dane o rezerwacjach z API partnerów.

Ten przewodnik jest przeznaczony dla zewnętrznych dostawców usług (np. OTA, brokerów, marketplace'ów), którzy chcą zintegrować się z ParkFlow i dostarczać swoje rezerwacje przez API.

Model działania

ParkFlow uruchamia zaplanowane zadania, które pobierają nowe lub zaktualizowane rezerwacje z API każdego partnera. Zadania te są zazwyczaj wykonywane:

- Co 2–10 minut w środowisku produkcyjnym
- Co 15–30 minut w trybie testowym

Pomaga to zapewnić operatorowi parkingu aktualne informacje o nadchodzących przyjazdach i wymaganiach serwisowych. 

Obsługiwane przypadki użycia

- Pobieranie nowych potwierdzonych rezerwacji
- Wykrywanie zaktualizowanych danych lotu lub klienta
- Rejestrowanie anulowań
- Obsługa zmian w ostatniej chwili bliskich czasu zameldowania

Wymagania dotyczące API

Jeśli właściciel parkingu posiada wiele ofert (np. różne parkingi lub produkty) w systemie zewnętrznym, ParkFlow ustanowi oddzielną integrację dla każdej oferty, aby zapewnić dokładne mapowanie, dostępność i synchronizację cen.

Aby integracja przebiegła sprawnie, zewnętrzni partnerzy muszą udostępnić publiczne REST API obsługujące następujące funkcje:

Uwierzytelnianie

ParkFlow obsługuje wiele schematów:

- Bearer Token: Authorization: Bearer <token>
- Basic Auth: nazwa użytkownika i hasło zakodowane w base64
- API Key: Przekazywany w nagłówku (preferowane) lub parametrze zapytania

Uwaga: Dane uwierzytelniające są bezpiecznie przechowywane i zarządzane w ramach platformy ParkFlow.

Endpointy

ParkFlow wymaga tylko jednego obowiązkowego endpointu:

GET /bookings – Ten endpoint musi zwracać listę wszystkich rezerwacji, które zostały utworzone, zaktualizowane lub anulowane od określonego momentu w czasie. ParkFlow używa go do niezawodnej synchronizacji danych z systemu zewnętrznego.

Obiekt rezerwacji powinien zawierać następujące informacje:

- Daty przyjazdu i wyjazdu powinny być w lokalnej strefie czasowej

- Daty utworzenia i aktualizacji powinny być w UTC-0

- Cena, kwota przedpłaty i waluta

- Status rezerwacji

- Liczba pojazdów i numery rejestracyjne

- Numer referencyjny

Opcjonalne endpointy:

- Blokowanie dostępności

Umożliwia ParkFlow informowanie systemu zewnętrznego, gdy określony produkt parkingowy nie jest już dostępny w podanych datach.

Przykład:

POST /parkings/{id}/locks

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

- Powiadomienie o statusie rezerwacji

Umożliwia ParkFlow powiadamianie systemu zewnętrznego o anulowaniach rezerwacji lub nieprzybyciu klienta (no-show) zainicjowanych przez parking.

Przykład:

POST /bookings/{id}/cancel

Body: { "reason": "no_show" }

- Aktualizacje cennika

 Umożliwia ParkFlow przesyłanie sezonowych lub podstawowych danych cenowych dla określonych ofert parkingowych.

 Przykład:

 POST /parkings/{id}/pricing

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

Zalecenia dotyczące integracji

- Zapewnij dokładne i terminowe odpowiedzi

- Unikaj buforowania nieaktualnych danych

- Zezwól ParkFlow na konfigurowanie częstotliwości odpytywania

- Obsługuj paginację dla dużych wolumenów rezerwacji

- Udostępnij środowisko sandbox/testowe z danymi testowymi

Wymagania bezpieczeństwa

- Wszystkie endpointy muszą działać przez HTTPS

- Używaj bezpiecznych metod uwierzytelniania (preferowane oparte na tokenach)

- Ogranicz dostęp na podstawie białej listy adresów IP, jeśli to możliwe

- Unikaj przechowywania wrażliwych danych klientów ponad to, co jest konieczne