Havalimanı hizmetleri

Transferin yanında havalimanı hizmetleri de satabilirsiniz: güvenlik ve pasaport kontrolünde fast track, VIP lounge ve uçak kapısından araca kadar karşılama (meet & assist). Tek başına ya da transferle aynı rezervasyonda alınabilir.

Transfer teklifinde ipucu

Transfer bir havalimanında başlıyor ya da bitiyorsa POST /quotes yanıtında airport_services da gelir: rezerve edilebilir hizmeti olan her havalimanı ucu için bir ipucu. Havalimanından alış arrival (varış), havalimanına bırakış departure (gidiş) demektir (lounge yalnız gidişte önerilir).

"airport_services": [
  { "airport": "AYT", "direction": "departure", "count": 2, "types": ["fast_track", "lounge"],
    "from": { "amount": 60.0, "currency": "EUR" }, "suggested_at": "2026-11-20T11:15",
    "search": "/api/v1/airport-services?airport=AYT&date=2026-11-20&time=11:15&direction=departure&adults=2&children=0&infants=0" }
]

suggested_at: varışta alış saati, gidişte havalimanına tahmini varış (alış + yol + güvenlik payı).
search: hizmetleri ve offer_id değerlerini almak için (anahtarınızla) çağırın. Hizmet yoksa ve saatlik tekliflerde dizi boştur.

Hizmetleri bulma

curl "https://paxvelhub.com/api/v1/airport-services?airport=IST&date=2026-11-20&time=09:30&direction=arrival&adults=2&children=1" \
  -H "Authorization: Bearer $PAXVEL_KEY"

Parametre	Zorunlu	Anlamı
`airport`	evet	Havalimanının IATA kodu.
`date`	evet	Hizmet tarihi, `YYYY-MM-DD`.
`time`	hayır	Yerel saat (iniş ya da kalkış), `HH:MM`. Varsayılan `12:00`.
`direction`	hayır	`arrival` ya da `departure`. Verilmezse ikisinin seçenekleri döner.
`adults`, `children`, `infants`	hayır	Yolcu sayısı; fiyat buna göre hesaplanır.

{
  "data": [
    {
      "id": 7, "type": "meet_assist", "name": "IST Meet & Assist", "airport": "IST", "terminal": "International",
      "meeting_point": "Uçak kapısı, isim tabelası",
      "description": "Kişisel karşılama, pasaport kontrolünde fast track ve araca kadar bagaj yardımı.",
      "options": [
        { "offer_id": "of_eyJ2Ijo…", "name": "Geliş — standart", "duration_hours": 2, "direction": "arrival", "price": 95.0, "currency": "EUR", "expires_at": "2026-11-01T09:30:00+00:00" }
      ]
    }
  ]
}

Her seçeneğin kendi offer_id değeri ve verilen yolcu sayısı için toplam fiyatı vardır.

Hizmet rezervasyonu

Hizmet tekliflerini services içinde gönderin — ikisini tek rezervasyonda istiyorsanız transfer items alanının yanında:

POST /bookings
{
  "services": [ { "offer_id": "of_eyJ2Ijo…", "flight_number": "TK1984", "at": "2026-11-20 09:30", "for_item": 0 } ],
  "items":    [ { "offer_id": "of_eyJ3Ij…", "flight_number": "TK1984" } ],
  "lead_passenger": { "name": "Anna Peeters", "phone": "+32 470 12 34 56" }
}

at (isteğe bağlı) hizmet saatini teklif tarihinde değiştirir, YYYY-MM-DD HH:MM yerel saat.
flight_number pratikte zorunludur: karşılama görevlisi yolcuyu buna göre bulur.
for_item (isteğe bağlı) hizmeti aynı istekteki bir transfere bağlar: items içindeki sıra (0'dan). Bağlı hizmet o transferle birlikte işlenir (ör. saati değişince).

Rezervasyonda hizmet, "type": "airport_service" olan ve service nesnesi (name, option) taşıyan bir kalem olarak görünür. Bağlı hizmette ayrıca linked_item_id (transfer kaleminin id'si) vardır.

← Fiyat ve rezervasyon Rezervasyon aşamaları →