AnasayfaPartner API
Geliştirici

Partner API Dökümantasyonu

OTA, acente ve kurumsal partnerler için REST API. Anlık fiyat sorgulayın, kendi sisteminizden rezervasyon oluşturun ve rezervasyonlarınızı takip edin.

1.Başlangıç

Lia Transfer API; partnerlerin kendi web sitesi, mobil uygulaması veya rezervasyon paneli üzerinden Lia Transfer transfer hizmetini satmasını sağlar. Tüm istekler HTTPS üzerinden, JSON formatında yapılır.

Temel Adres (Base URL)

https://api.liatransfer.com/api/v1
Tipik akış: önce /pricing/query ile uygun araç tiplerini ve fiyatları alın, müşteriye gösterin; sonra seçilen vehicle_type ile /bookings çağırarak rezervasyonu oluşturun.

2.Kimlik Doğrulama

Her istek, size özel API anahtarınızı x-api-key başlığında (header) taşımalıdır. API anahtarı tk_ ön ekiyle başlar.

x-api-key: tk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
API anahtarı almak için Trogo ile partner sözleşmesi yapıp [email protected] adresinden talep edin. Anahtarınızı gizli tutun, istemci tarafı (tarayıcı) kodunda ifşa etmeyin.

Örnek — cURL

curl -X GET "https://api.liatransfer.com/api/v1/bookings/mine" \
  -H "x-api-key: tk_xxxxxxxx..."

3.İstek Limiti (Rate Limit)

Her partner için dakikada 60 istek sınırı vardır. Sınır aşıldığında API 429 Too Many Requests döner ve yanıtta retryAfter (saniye) alanı bulunur.

{
  "statusCode": 429,
  "message": "Rate limit aşıldı: dakikada en fazla 60 istek",
  "retryAfter": 60
}

4.Fiyat Sorgula

Alış ve bırakış koordinatlarına göre mevcut araç tiplerini ve güncel fiyatları döner. Entegrasyonun ana giriş noktasıdır.

GET/pricing/query

Sorgu Parametreleri

ParametreTipAçıklama
pickup_latzorunlunumberAlış noktası enlemi (-90…90). Örn: 41.2628
pickup_lngzorunlunumberAlış noktası boylamı (-180…180). Örn: 28.7290
dropoff_latzorunlunumberBırakış noktası enlemi. Örn: 41.0082
dropoff_lngzorunlunumberBırakış noktası boylamı. Örn: 28.9784
passengerszorunlunumberYolcu sayısı (≥1).
pickup_timezorunluISO 8601Alış tarih-saati. Örn: 2026-11-10T14:00:00Z
currencyopsiyonelstringPara birimi (varsayılan TRY).

Örnek İstek

curl -G "https://api.liatransfer.com/api/v1/pricing/query" \
  -H "x-api-key: tk_xxxxxxxx..." \
  --data-urlencode "pickup_lat=41.2628" \
  --data-urlencode "pickup_lng=28.7290" \
  --data-urlencode "dropoff_lat=41.0082" \
  --data-urlencode "dropoff_lng=28.9784" \
  --data-urlencode "passengers=2" \
  --data-urlencode "pickup_time=2026-11-10T14:00:00Z"

Örnek Yanıt

{
  "from_zone": { "id": 12, "name": "İstanbul Havalimanı", "city": "İstanbul" },
  "to_zone":   { "id": 3,  "name": "Taksim", "city": "İstanbul" },
  "pickup_time": "2026-11-10T14:00:00Z",
  "passengers": 2,
  "vehicles": [
    {
      "type": "sedan",
      "name": "Sedan",
      "max_passengers": 4,
      "price": 1850.00,
      "currency": "TRY",
      "price_eur": null,
      "price_usd": null
    }
  ]
}
Yanıttaki her aracın type değerini (ör. sedan), rezervasyon adımında vehicle_type alanına aynen geçirin. Rota için fiyat tanımlı değilse vehicles boş döner.

5.Rezervasyon Oluştur

Partner adına yeni bir transfer rezervasyonu oluşturur. Fiyat, seçilen vehicle_type ve rota üzerinden sunucuda otomatik hesaplanır.

POST/bookings

İstek Gövdesi (JSON)

AlanTipAçıklama
pickup_addresszorunlustringAlış adresi (en az 3 karakter).
dropoff_addresszorunlustringBırakış adresi (en az 3 karakter).
pickup_timezorunluISO 8601Alış tarih-saati.
passengerszorunlunumberYolcu sayısı (≥1).
vehicle_typezorunlustringFiyat sorgusundan gelen araç tipi. Örn: sedan
contact_namezorunlustringYolcu ad soyad.
contact_phonezorunlustringYolcu telefonu. Örn: +905551234567
pickup_latopsiyonelnumberAlış enlemi (harita entegrasyonu için önerilir).
pickup_lngopsiyonelnumberAlış boylamı.
dropoff_latopsiyonelnumberBırakış enlemi.
dropoff_lngopsiyonelnumberBırakış boylamı.
vehicle_type_nameopsiyonelstringAraç tipi görünen adı. Örn: Mercedes Vip Vito
contact_emailopsiyonelemailYolcu e-posta adresi.
flight_noopsiyonelstringUçuş numarası. Örn: TK123
partner_refopsiyonelstringSizin sisteminizdeki referans no (mutabakatta kolaylık sağlar).

Örnek İstek

curl -X POST "https://api.liatransfer.com/api/v1/bookings" \
  -H "x-api-key: tk_xxxxxxxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "pickup_address": "İstanbul Havalimanı Terminal 1",
    "dropoff_address": "Taksim Meydanı",
    "pickup_time": "2026-11-10T14:00:00Z",
    "passengers": 2,
    "vehicle_type": "sedan",
    "contact_name": "Ahmet Yılmaz",
    "contact_phone": "+905551234567",
    "flight_no": "TK123",
    "partner_ref": "RES-2026-0001"
  }'

6.Rezervasyonlarım

API anahtarınıza bağlı tüm rezervasyonları listeler.

GET/bookings/mine
curl -X GET "https://api.liatransfer.com/api/v1/bookings/mine" \
  -H "x-api-key: tk_xxxxxxxx..."

7.Hata Kodları

API standart HTTP durum kodları döner. Hata gövdesi statusCode ve message alanlarını içerir.

400Bad Request — Eksik/geçersiz parametre (ör. enlem-boylam aralığı, zorunlu alan boş).
401Unauthorized — API anahtarı eksik, geçersiz veya hesap aktif değil.
429Too Many Requests — Dakikalık istek limiti aşıldı. retryAfter kadar bekleyin.
500Server Error — Beklenmeyen sunucu hatası. Sorun sürerse bizimle iletişime geçin.

8.İnteraktif Referans (Swagger)

Tüm uç noktaları canlı olarak deneyebileceğiniz interaktif API referansına aşağıdan ulaşabilirsiniz.