Size nasıl yardımcı olabiliriz?

ParkFlow.io, merkezi bir platform (kanal yöneticisi) olarak havalimanı otopark işletmecilerini çevrimiçi seyahat acenteleri (OTA'lar), toplayıcılar, brokerlar ve B2C siteleri gibi çeşitli satış kanallarıyla buluşturur. Rezervasyonları, güncellemeleri ve iptalleri birden fazla kaynaktan tek bir arayüzde senkronize ederek otopark yönetimini kolaylaştıran bir ara katman sistemi işlevi görür. ParkFlow öncelikli olarak çekme tabanlı entegrasyon modeline dayanır; bu modelde rezervasyon verileri iş ortağı API'lerinden periyodik olarak çekilir.

Bu kılavuz, ParkFlow ile entegre olmak ve API aracılığıyla rezervasyon sağlamak isteyen harici hizmet sağlayıcılar (ör. OTA'lar, brokerlar, pazaryerleri) için hazırlanmıştır.

Çalışma Modeli

ParkFlow, her iş ortağının API'sinden yeni veya güncellenmiş rezervasyonları çeken zamanlanmış görevler çalıştırır. Bu görevler genellikle şu sıklıkla yürütülür:

- Canlı ortamda her 2–10 dakikada bir
- Test modunda her 15–30 dakikada bir

Bu sayede otopark işletmecisinin yaklaşan varışlar ve hizmet gereksinimleri hakkında güncel bilgiye sahip olması sağlanır. 

Kapsanan Kullanım Senaryoları

- Yeni onaylanmış rezervasyonların çekilmesi
- Güncellenen uçuş veya müşteri bilgilerinin tespit edilmesi
- İptallerin yakalanması
- Check-in saatine yakın son dakika değişikliklerinin yönetilmesi

API Gereksinimleri

Bir otopark sahibinin harici sistemde birden fazla teklifi (ör. farklı otoparklar veya ürünler) varsa ParkFlow, doğru eşleme, müsaitlik ve fiyat senkronizasyonunu sağlamak amacıyla her teklif için ayrı bir entegrasyon oluşturacaktır.

Sorunsuz bir entegrasyon için harici iş ortakları, aşağıdakileri destekleyen bir herkese açık REST API'si sunmalıdır:

Kimlik Doğrulama

ParkFlow birden fazla şemayı destekler:

- Bearer Token: Authorization: Bearer <token>
- Basic Auth: base64 ile kodlanmış kullanıcı adı:parola
- API Key: Başlıkta (tercih edilen) veya sorgu parametresi olarak iletilir

Not: Kimlik bilgileri ParkFlow platformunda güvenli biçimde saklanır ve yönetilir.

Uç Noktalar

ParkFlow yalnızca tek bir zorunlu uç nokta gerektirir:

GET /bookings – Bu uç nokta, belirli bir tarihten itibaren oluşturulmuş, güncellenmiş veya iptal edilmiş tüm rezervasyonların listesini döndürmelidir. ParkFlow bu uç noktayı harici sistemden güvenilir biçimde veri senkronize etmek için kullanır.

Rezervasyon nesnesi aşağıdaki bilgileri içermelidir:

- Varış ve Ayrılış tarihleri yerel saat diliminde olmalıdır

- Oluşturulma ve güncellenme tarihleri UTC-0 olmalıdır

- Fiyat, ön ödemeli tutar ve para birimi

- Rezervasyonun durumu

- Araç sayısı ve plakalar

- Referans numarası

İsteğe bağlı uç noktalar:

- Müsaitlik Kilitleme

ParkFlow'un, belirli bir otopark ürününün belirli tarihlerde artık müsait olmadığını harici sisteme bildirmesine olanak tanır.

Örnek:

POST /parkings/{id}/locks

Body: { "date": "2025-07-15", "reason": "full" }

- Rezervasyon Durum Bildirimi

ParkFlow'un, otopark tarafından başlatılan rezervasyon iptalleri veya gelmeme durumları hakkında harici sistemi bilgilendirmesine olanak tanır.

Örnek:

POST /bookings/{id}/cancel

Body: { "reason": "no_show" }

- Fiyat Güncellemeleri

 ParkFlow'un belirli otopark teklifleri için sezonluk veya temel fiyatlandırma verilerini göndermesini sağlar.

 Örnek:

 POST /parkings/{id}/pricing

 Body: { "type": "seasonal", "valid_from": "...", "valid_until": "...", "prices": [6500, ... }

Entegrasyon Önerileri

- Doğru ve zamanında yanıtlar sağlayın

- Güncel olmayan verileri önbelleğe almaktan kaçının

- ParkFlow'un sorgulama sıklığını yapılandırmasına izin verin

- Büyük rezervasyon hacimleri için sayfalamayı destekleyin

- Test verisiyle birlikte bir sandbox/test ortamı sağlayın

Güvenlik Gereksinimleri

- Tüm uç noktalar HTTPS üzerinden çalışmalıdır

- Güvenli kimlik doğrulama yöntemleri kullanın (token tabanlı tercih edilir)

- Mümkünse IP beyaz listesine göre erişimi kısıtlayın

- Hassas müşteri verilerini gereğinden fazla saklamaktan kaçının