ParkFlow.io — це channel manager для аеропортових паркінгів, що з'єднує кілька джерел бронювань (OTA, брокери, вебсайти, агрегатори) з операторами паркінгів. ParkFlow працює переважно за моделлю витягування (pull-based), періодично отримуючи бронювання із підключених зовнішніх систем.
ParkFlow.io — це централізована платформа (channel manager), яка з'єднує операторів аеропортових паркінгів з різноманітними каналами продажів, такими як онлайн-туристичні агентства (OTA), агрегатори, брокери та B2C-сайти. Вона виступає як проміжна система, що спрощує управління бронюваннями для паркінгів шляхом синхронізації резервацій, оновлень і скасувань із кількох джерел в єдиному інтерфейсі. ParkFlow переважно використовує модель інтеграції на основі витягування (pull-based), за якої вона періодично отримує дані про бронювання з API партнерів.
Цей посібник призначений для зовнішніх постачальників послуг (наприклад, OTA, брокерів, маркетплейсів), які хочуть інтегруватися з ParkFlow та надавати свої бронювання через API.
ParkFlow запускає заплановані завдання, які витягують нові або оновлені бронювання з API кожного партнера. Ці завдання зазвичай виконуються:
- Кожні 2–10 хвилин у виробничому середовищі
- Кожні 15–30 хвилин у тестовому режимі
Це допомагає забезпечити оператора паркінгу актуальною інформацією про майбутні прибуття та вимоги до обслуговування.
- Отримання нових підтверджених резервацій
- Виявлення оновлень деталей рейсу або клієнта
- Фіксація скасувань
- Обробка змін в останню хвилину перед реєстрацією
Якщо власник паркінгу має кілька пропозицій (наприклад, різні паркінги або продукти) у зовнішній системі, ParkFlow встановить окрему інтеграцію для кожної пропозиції, щоб забезпечити точне зіставлення, синхронізацію доступності та цін.
Для безперебійної інтеграції зовнішні партнери повинні надати публічний REST API, який підтримує наступне:
ParkFlow підтримує кілька схем:
- Bearer Token: Authorization: Bearer <token>- Basic Auth: base64-кодований user:password
- API Key: Передається в заголовку (рекомендовано) або як параметр запиту
Примітка: Облікові дані надійно зберігаються та управляються в межах платформи ParkFlow.
ParkFlow вимагає лише один обов'язковий ендпоінт:
GET /bookings – Цей ендпоінт повинен повертати список усіх бронювань, які були створені, оновлені або скасовані з певного моменту часу. ParkFlow використовує це для надійної синхронізації даних із зовнішньої системи.
Об'єкт бронювання повинен містити таку інформацію:
- Дати прибуття та від'їзду мають бути у місцевому часовому поясі
- Дати створення та оновлення мають бути в UTC-0
- Ціна, попередньо оплачена сума та валюта
- Статус резервації
- Кількість транспортних засобів та номерні знаки
- Номер довідки
Необов'язкові ендпоінти:
- Блокування доступності
Дозволяє ParkFlow повідомляти зовнішню систему, коли певний продукт паркінгу недоступний на конкретні дати.
Приклад:
POST /parkings/{id}/locks
Body: { "date": "2025-07-15", "reason": "full" }
- Сповіщення про статус бронювання
Дозволяє ParkFlow сповіщати зовнішню систему про скасування бронювань або неявки, ініційовані паркінгом.
Приклад:
POST /bookings/{id}/cancel
Body: { "reason": "no_show" }
- Оновлення цін
Дозволяє ParkFlow надсилати сезонні або базові цінові дані для конкретних пропозицій паркінгу.
Приклад:
POST /parkings/{id}/pricing
Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Забезпечте точні та своєчасні відповіді
- Уникайте кешування застарілих даних
- Дозвольте ParkFlow налаштовувати частоту опитування
- Підтримуйте пагінацію для великих обсягів бронювань
- Надайте пісочницю/тестове середовище з тестовими даними
- Всі ендпоінти повинні використовувати HTTPS
- Використовуйте безпечні методи автентифікації (перевага — на основі токенів)
- Обмежуйте доступ за допомогою білого списку IP-адрес, якщо це можливо
- Уникайте зберігання конфіденційних даних клієнтів понад необхідний мінімум