Başlarken

Paxvel Hub API ile platformunuz 50'den fazla ülkede özel havalimanı transferi, saatlik şoförlü araç ve havalimanı hizmetlerini (fast track, VIP lounge, karşılama) fiyatlayıp rezerve edebilir. Bütün canlı rezervasyonları operasyon ekibimiz gerçekleştirir ve sizi bildirimlerle (webhook) haberdar eder.

Bu rehber sizi yaklaşık on beş dakikada ilk test rezervasyonunuza götürür.

Erişim nasıl işler

1. Başvuru sayfasından erişim isteyin. Bu portala giriş linkiniz hemen gelir.
2. Başvurunuzu genellikle bir iş günü içinde inceleriz. Onaylanınca Panelim → API anahtarları'ndan test anahtarı oluşturabilirsiniz.
3. Test ortamında geliştirip deneyin. Test anahtarları gerçek fiyat döner ama rezervasyonlar operasyona hiç ulaşmaz.
4. Canlıya geçiş kontrol listesini tamamlayıp canlı erişim isteyin. Onaydan sonra canlı anahtar oluşturabilirsiniz.

Temel adres ve biçim

Her cevapta bir request_id bulunur. Bir istekle ilgili bize yazarken bu değeri ekleyin.

İlk isteğiniz

Anahtarınızın çalıştığını kontrol edin:

curl https://paxvelhub.com/api/v1/ping \
  -H "Authorization: Bearer $PAXVEL_KEY"

{
  "data": { "ok": true, "env": "test", "account": "Şirketiniz", "currency": "EUR", "time": "2026-11-01T09:00:00+00:00" },
  "request_id": "3f2a9c0d1e4b5a67"
}

Tek adres iki ortama da hizmet eder: test mi canlı mı olduğunu anahtar belirler. Uygulamanız açılırken GET /ping çağırıp env değerinin beklediğiniz gibi (test ya da live) olduğunu kontrol edin.

Önce fiyat, sonra rezervasyon

Rezervasyon her zaman fiyat sorgusuyla başlar. Sorgu, her araç tipi için bir teklif döner; teklifi offer_id değeriyle rezerve edersiniz.

curl -X POST https://paxvelhub.com/api/v1/quotes \
  -H "Authorization: Bearer $PAXVEL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": { "iata": "AYT" },
    "to":   { "address": "Regnum Carya, Belek", "lat": 36.8620, "lng": 31.0560, "country": "TR" },
    "date": "2026-11-20", "time": "14:30",
    "passengers": { "adults": 2, "children": 1 },
    "luggage": 3
  }'

Bir teklif seçip rezerve edin:

curl -X POST https://paxvelhub.com/api/v1/bookings \
  -H "Authorization: Bearer $PAXVEL_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-10045" \
  -d '{
    "items": [ { "offer_id": "of_eyJ2Ijo…", "flight_number": "TK2412" } ],
    "lead_passenger": { "name": "Anna Peeters", "phone": "+32 470 12 34 56", "email": "anna@example.com" },
    "reference": "ORDER-10045"
  }'

Cevap rezervasyonun kendisidir: bizim rezervasyon numaramız (örneğin PXT-01234, test ortamında TEST-…) ve durumu. Ayrıntılar için Fiyat ve rezervasyon sayfasına geçin.

Kod yazmadan deneyin

Konsol, test anahtarınızla tarayıcıdan gerçek istek gönderir; API referansı bütün uç noktaları ve alanları listeler. İstemci kodu üretmek isterseniz tanımın tamamı OpenAPI 3.1 olarak hazır.

Yardım

Her şeyi Panelim → Sorular bölümünden sorabilirsiniz. Entegrasyon ekibimiz orada ve e-postayla cevap verir.