ParkFlow.io é um gestor de canais para parques de estacionamento em aeroportos, conectando múltiplas fontes de reservas (OTAs, corretores, websites, agregadores) com operadores de estacionamento. ParkFlow funciona principalmente num modelo baseado em pull, obtendo periodicamente reservas de sistemas externos integrados.
ParkFlow.io é uma plataforma centralizada (gestor de canais) que conecta operadores de estacionamento em aeroportos com vários canais de venda como agências de viagens online (OTAs), agregadores, corretores e sites B2C. Atua como um sistema de middleware, simplificando a gestão de reservas para parques de estacionamento, sincronizando reservas, atualizações e cancelamentos de múltiplas fontes numa interface unificada. ParkFlow baseia-se principalmente num modelo de integração baseado em pull, onde obtém periodicamente dados de reservas a partir de APIs de parceiros.
Este guia destina-se a prestadores de serviços externos (por exemplo, OTAs, corretores, marketplaces) que pretendam integrar-se com ParkFlow e fornecer as suas reservas através de uma API.
ParkFlow executa tarefas agendadas que obtêm reservas novas ou atualizadas a partir da API de cada parceiro. Estas tarefas são normalmente executadas:
- A cada 2–10 minutos em produção
- A cada 15–30 minutos em modo de teste
Isto ajuda a garantir que o operador de estacionamento dispõe de informação atualizada sobre chegadas previstas e requisitos de serviço.
- Obtenção de novas reservas confirmadas
- Deteção de atualizações de voo ou dados do cliente
- Registo de cancelamentos
- Gestão de alterações de última hora próximas do horário de check-in
Se o proprietário de um parque de estacionamento tiver múltiplas ofertas (por exemplo, diferentes parques ou produtos) no sistema externo, ParkFlow estabelecerá uma integração separada para cada oferta, de modo a garantir um mapeamento preciso, bem como a sincronização de disponibilidade e preços.
Para uma integração sem problemas, os parceiros externos devem disponibilizar uma API REST pública que suporte o seguinte:
ParkFlow suporta múltiplos esquemas:
- Bearer Token: Authorization: Bearer <token>- Basic Auth: utilizador:palavra-passe codificados em base64
- API Key: Passado no cabeçalho (preferido) ou como parâmetro de consulta
Nota: As credenciais são armazenadas e geridas de forma segura dentro da plataforma ParkFlow.
ParkFlow requer apenas um único endpoint obrigatório:
GET /bookings – Este endpoint deve devolver uma lista de todas as reservas que foram criadas, atualizadas ou canceladas desde um determinado momento. ParkFlow utiliza-o para sincronizar dados de forma fiável a partir do sistema externo.
O objeto de reserva deve conter as seguintes informações:
- As datas de chegada e partida devem estar no fuso horário local
- As datas de criação e atualização devem estar em UTC-0
- Preço, montante pré-pago e moeda
- Estado da reserva
- Número de veículos e matrículas
- Número de referência
Endpoints opcionais:
- Bloqueio de Disponibilidade
Permite ao ParkFlow informar o sistema externo quando um produto de estacionamento específico deixa de estar disponível em determinadas datas.
Exemplo:
POST /parkings/{id}/locks
Body: { "date": "2025-07-15", "reason": "full" }
- Notificação do Estado da Reserva
Permite ao ParkFlow notificar o sistema externo sobre cancelamentos de reservas ou não comparências iniciadas pelo parque de estacionamento.
Exemplo:
POST /bookings/{id}/cancel
Body: { "reason": "no_show" }
- Atualizações de Preços
Permite ao ParkFlow enviar dados de preços sazonais ou base para ofertas de estacionamento específicas.
Exemplo:
POST /parkings/{id}/pricing
Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }
- Garantir respostas precisas e atempadas
- Evitar a utilização de dados desatualizados em cache
- Permitir ao ParkFlow configurar a frequência de polling
- Suportar paginação para grandes volumes de reservas
- Disponibilizar um ambiente de sandbox/teste com dados de teste
- Todos os endpoints devem utilizar HTTPS
- Utilizar métodos de autenticação seguros (preferir autenticação baseada em token)
- Limitar o acesso com base em listas de permissão de IP, se possível
- Evitar armazenar dados sensíveis de clientes além do estritamente necessário