ParkFlow.io est un gestionnaire de canaux pour les parkings d'aéroport, connectant plusieurs sources de réservation (OTA, courtiers, sites web, agrégateurs) avec les exploitants de parkings. ParkFlow fonctionne principalement selon un modèle basé sur l'extraction (pull), en récupérant périodiquement les réservations depuis les systèmes externes intégrés.
ParkFlow.io est une plateforme centralisée (gestionnaire de canaux) qui connecte les exploitants de parkings aéroportuaires avec différents canaux de vente tels que les agences de voyage en ligne (OTA), les agrégateurs, les courtiers et les sites B2C. Elle agit comme un système intermédiaire (middleware), simplifiant la gestion des réservations pour les parkings en synchronisant les réservations, les mises à jour et les annulations provenant de plusieurs sources dans une interface unifiée. ParkFlow s'appuie principalement sur un modèle d'intégration basé sur l'extraction (pull), où il récupère périodiquement les données de réservation depuis les API partenaires.
Ce guide est destiné aux prestataires de services externes (ex. OTA, courtiers, places de marché) souhaitant s'intégrer à ParkFlow et transmettre leurs réservations via une API.
ParkFlow exécute des tâches planifiées qui extraient les réservations nouvelles ou mises à jour depuis l'API de chaque partenaire. Ces tâches s'exécutent généralement :
- Toutes les 2 à 10 minutes en production
- Toutes les 15 à 30 minutes en mode test
Cela permet de garantir que l'exploitant du parking dispose d'informations à jour sur les arrivées prévues et les exigences de service.
- Récupération des nouvelles réservations confirmées
- Détection des mises à jour de vol ou des informations client
- Prise en compte des annulations
- Gestion des modifications de dernière minute à l'approche du check-in
Si un propriétaire de parking dispose de plusieurs offres (ex. différents parkings ou produits) dans le système externe, ParkFlow établira une intégration distincte pour chaque offre afin de garantir une correspondance précise ainsi que la synchronisation des disponibilités et des tarifs.
Pour une intégration fluide, les partenaires externes doivent exposer une API REST publique prenant en charge les éléments suivants :
ParkFlow prend en charge plusieurs méthodes :
- Bearer Token : Authorization: Bearer <token>- Basic Auth : utilisateur:mot de passe encodé en base64
- API Key : Transmise dans l'en-tête (recommandé) ou en paramètre de requête
Remarque : Les identifiants sont stockés et gérés de manière sécurisée au sein de la plateforme ParkFlow.
ParkFlow ne requiert qu'un seul point de terminaison obligatoire :
GET /bookings – Ce point de terminaison doit retourner la liste de toutes les réservations créées, modifiées ou annulées depuis un moment précis. ParkFlow l'utilise pour synchroniser les données de manière fiable depuis le système externe.
L'objet de réservation doit contenir les informations suivantes :
- Les dates d'arrivée et de départ doivent être exprimées dans le fuseau horaire local
- Les dates de création et de modification doivent être en UTC-0
- Le prix, le montant prépayé et la devise
- Le statut de la réservation
- Le nombre de véhicules et les plaques d'immatriculation
- Le numéro de référence
Points de terminaison optionnels :
- Verrouillage des disponibilités
Permet à ParkFlow d'informer le système externe lorsqu'un produit de stationnement spécifique n'est plus disponible à certaines dates.
Exemple :
POST /parkings/{id}/locks
Body: { "date": "2025-07-15", "reason": "full" }
- Notification de statut de réservation
Permet à ParkFlow de notifier le système externe des annulations de réservation ou des non-présentations initiées par le parking.
Exemple :
POST /bookings/{id}/cancel
Body: { "reason": "no_show" }
- Mises à jour tarifaires
Permet à ParkFlow d'envoyer des données tarifaires saisonnières ou de base pour des offres de stationnement spécifiques.
Exemple :
POST /parkings/{id}/pricing
Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Garantir des réponses précises et dans les délais
- Éviter la mise en cache de données obsolètes
- Permettre à ParkFlow de configurer la fréquence d'interrogation
- Prendre en charge la pagination pour les grands volumes de réservations
- Fournir un environnement sandbox/de test avec des données de test
- Tous les points de terminaison doivent utiliser HTTPS
- Utiliser des méthodes d'authentification sécurisées (privilégier l'authentification par jeton)
- Restreindre l'accès par liste blanche d'adresses IP si possible
- Éviter de stocker des données client sensibles au-delà de ce qui est nécessaire