ParkFlow.io ist ein Channel-Manager für Flughafenparkplätze und verbindet mehrere Buchungsquellen (OTAs, Broker, Websites, Aggregatoren) mit Parkplatzbetreibern. ParkFlow arbeitet primär nach einem Pull-basierten Modell und ruft Buchungen regelmäßig aus integrierten externen Systemen ab.
ParkFlow.io ist eine zentrale Plattform (Channel-Manager), die Flughafenparkplatzbetreiber mit verschiedenen Vertriebskanälen wie Online-Reisebüros (OTAs), Aggregatoren, Brokern und B2C-Websites verbindet. Sie fungiert als Middleware-System und vereinfacht das Buchungsmanagement für Parkplätze, indem Reservierungen, Aktualisierungen und Stornierungen aus mehreren Quellen in einer einheitlichen Oberfläche synchronisiert werden. ParkFlow setzt primär auf ein Pull-basiertes Integrationsmodell, bei dem Buchungsdaten regelmäßig von Partner-APIs abgerufen werden.
Dieser Leitfaden richtet sich an externe Dienstleister (z. B. OTAs, Broker, Marktplätze), die sich mit ParkFlow integrieren und ihre Buchungen über eine API bereitstellen möchten.
ParkFlow führt geplante Jobs aus, die neue oder aktualisierte Buchungen von der API jedes Partners abrufen. Diese Jobs werden typischerweise ausgeführt:
- Alle 2–10 Minuten im Produktivbetrieb
- Alle 15–30 Minuten im Testmodus
Dies stellt sicher, dass der Parkplatzbetreiber stets aktuelle Informationen zu bevorstehenden Ankünften und Serviceanforderungen erhält.
- Abruf neuer bestätigter Reservierungen
- Erkennung aktualisierter Flug- oder Kundendaten
- Erfassung von Stornierungen
- Verarbeitung kurzfristiger Änderungen kurz vor dem Check-in
Wenn ein Parkplatzbetreiber mehrere Angebote (z. B. verschiedene Parkplätze oder Produkte) im externen System hat, richtet ParkFlow für jedes Angebot eine separate Integration ein, um eine genaue Zuordnung sowie die Synchronisierung von Verfügbarkeit und Preisen sicherzustellen.
Für eine reibungslose Integration müssen externe Partner eine öffentliche REST-API bereitstellen, die Folgendes unterstützt:
ParkFlow unterstützt mehrere Verfahren:
- Bearer Token: Authorization: Bearer <token>- Basic Auth: Base64-kodiertes Benutzername:Passwort
- API Key: Übergabe im Header (bevorzugt) oder als Query-Parameter
Hinweis: Zugangsdaten werden sicher innerhalb der ParkFlow-Plattform gespeichert und verwaltet.
ParkFlow erfordert nur einen einzigen obligatorischen Endpunkt:
GET /bookings – Dieser Endpunkt muss eine Liste aller Buchungen zurückgeben, die seit einem bestimmten Zeitpunkt erstellt, aktualisiert oder storniert wurden. ParkFlow verwendet dies, um Daten zuverlässig aus dem externen System zu synchronisieren.
Das Buchungsobjekt sollte folgende Informationen enthalten:
- An- und Abreisedaten sollten in der lokalen Zeitzone angegeben werden
- Erstellungs- und Aktualisierungsdaten sollten in UTC-0 angegeben werden
- Preis, Vorauszahlungsbetrag und Währung
- Status der Reservierung
- Anzahl der Fahrzeuge und Kennzeichen
- Referenznummer
Optionale Endpunkte:
- Verfügbarkeitssperrung
Ermöglicht es ParkFlow, das externe System zu informieren, wenn ein bestimmtes Parkprodukt an bestimmten Daten nicht mehr verfügbar ist.
Beispiel:
POST /parkings/{id}/locks
Body: { "date": "2025-07-15", "reason": "full" }
- Buchungsstatusbenachrichtigung
Ermöglicht es ParkFlow, das externe System über Buchungsstornierungen oder No-Shows zu benachrichtigen, die vom Parkplatzbetreiber initiiert wurden.
Beispiel:
POST /bookings/{id}/cancel
Body: { "reason": "no_show" }
- Preisaktualisierungen
Ermöglicht ParkFlow, saisonale oder Basispreisdaten für bestimmte Parkangebote zu übermitteln.
Beispiel:
POST /parkings/{id}/pricing
Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Genaue und zeitnahe Antworten sicherstellen
- Veraltete Daten nicht aus dem Cache bereitstellen
- ParkFlow die Konfiguration der Abrufhäufigkeit ermöglichen
- Paginierung für große Buchungsvolumen unterstützen
- Eine Sandbox-/Testumgebung mit Testdaten bereitstellen
- Alle Endpunkte müssen HTTPS verwenden
- Sichere Authentifizierungsmethoden verwenden (Token-basiert bevorzugt)
- Zugriff nach Möglichkeit per IP-Whitelisting einschränken
- Keine sensiblen Kundendaten über das notwendige Maß hinaus speichern