ParkFlow.io е мениджър на канали за летищни паркинги, свързващ множество източници на резервации (OTA, брокери, уебсайтове, агрегатори) с оператори на паркинги. ParkFlow работи основно с модел на извличане (pull-based), като периодично получава резервации от интегрирани външни системи.
ParkFlow.io е централизирана платформа (мениджър на канали), която свързва оператори на летищни паркинги с различни канали за продажби, като онлайн туристически агенции (OTA), агрегатори, брокери и B2C сайтове. Тя функционира като middleware система, опростяваща управлението на резервации за паркинги чрез синхронизиране на резервации, актуализации и отмени от множество източници в единен интерфейс. 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-кодирано потребителско_име:парола
- API Key: Предаден в хедъра (препоръчително) или като параметър на заявката
Забележка: Идентификационните данни се съхраняват и управляват сигурно в платформата на ParkFlow.
ParkFlow изисква само една задължителна крайна точка:
GET /bookings – Тази крайна точка трябва да върне списък с всички резервации, които са създадени, актуализирани или отменени от определен момент в времето. ParkFlow използва това за надеждно синхронизиране на данни от външната система.
Обектът на резервацията трябва да съдържа следната информация:
- Датите на пристигане и заминаване трябва да са в местна часова зона
- Датите на създаване и актуализиране трябва да са в UTC-0
- Цена, предплатена сума и валута
- Статус на резервацията
- Брой превозни средства и регистрационни номера
- Референтен номер
Незадължителни крайни точки:
- Заключване на наличност
Позволява на ParkFlow да информира външната система, когато даден паркинг продукт вече не е наличен за определени дати.
Пример:
POST /parkings/{id}/locks
Тяло: { "date": "2025-07-15", "reason": "full" }
- Известяване за статус на резервация
Позволява на ParkFlow да уведомява външната система за отмени на резервации или неявявания, инициирани от паркинга.
Пример:
POST /bookings/{id}/cancel
Тяло: { "reason": "no_show" }
- Актуализации на цени
Позволява на ParkFlow да изпраща сезонни или базови ценови данни за конкретни паркинг оферти.
Пример:
POST /parkings/{id}/pricing
Тяло: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Осигурете точни и навременни отговори
- Избягвайте кеширане на остарели данни
- Позволете на ParkFlow да конфигурира честотата на извличане
- Поддържайте пагинация за голям обем резервации
- Осигурете sandbox/тестова среда с тестови данни
- Всички крайни точки трябва да използват HTTPS
- Използвайте сигурни методи за удостоверяване (предпочитайте базирани на токени)
- Ограничавайте достъпа чрез IP белия списък, ако е възможно
- Избягвайте съхраняването на чувствителни клиентски данни извън необходимото