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.
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.
https://api.liatransfer.com/api/v1/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.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
curl -X GET "https://api.liatransfer.com/api/v1/bookings/mine" \ -H "x-api-key: tk_xxxxxxxx..."
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
}Alış ve bırakış koordinatlarına göre mevcut araç tiplerini ve güncel fiyatları döner. Entegrasyonun ana giriş noktasıdır.
| Parametre | Tip | Açıklama |
|---|---|---|
| pickup_latzorunlu | number | Alış noktası enlemi (-90…90). Örn: 41.2628 |
| pickup_lngzorunlu | number | Alış noktası boylamı (-180…180). Örn: 28.7290 |
| dropoff_latzorunlu | number | Bırakış noktası enlemi. Örn: 41.0082 |
| dropoff_lngzorunlu | number | Bırakış noktası boylamı. Örn: 28.9784 |
| passengerszorunlu | number | Yolcu sayısı (≥1). |
| pickup_timezorunlu | ISO 8601 | Alış tarih-saati. Örn: 2026-11-10T14:00:00Z |
| currencyopsiyonel | string | Para birimi (varsayılan TRY). |
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"
{
"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
}
]
}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.Partner adına yeni bir transfer rezervasyonu oluşturur. Fiyat, seçilen vehicle_type ve rota üzerinden sunucuda otomatik hesaplanır.
| Alan | Tip | Açıklama |
|---|---|---|
| pickup_addresszorunlu | string | Alış adresi (en az 3 karakter). |
| dropoff_addresszorunlu | string | Bırakış adresi (en az 3 karakter). |
| pickup_timezorunlu | ISO 8601 | Alış tarih-saati. |
| passengerszorunlu | number | Yolcu sayısı (≥1). |
| vehicle_typezorunlu | string | Fiyat sorgusundan gelen araç tipi. Örn: sedan |
| contact_namezorunlu | string | Yolcu ad soyad. |
| contact_phonezorunlu | string | Yolcu telefonu. Örn: +905551234567 |
| pickup_latopsiyonel | number | Alış enlemi (harita entegrasyonu için önerilir). |
| pickup_lngopsiyonel | number | Alış boylamı. |
| dropoff_latopsiyonel | number | Bırakış enlemi. |
| dropoff_lngopsiyonel | number | Bırakış boylamı. |
| vehicle_type_nameopsiyonel | string | Araç tipi görünen adı. Örn: Mercedes Vip Vito |
| contact_emailopsiyonel | Yolcu e-posta adresi. | |
| flight_noopsiyonel | string | Uçuş numarası. Örn: TK123 |
| partner_refopsiyonel | string | Sizin sisteminizdeki referans no (mutabakatta kolaylık sağlar). |
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"
}'API anahtarınıza bağlı tüm rezervasyonları listeler.
curl -X GET "https://api.liatransfer.com/api/v1/bookings/mine" \ -H "x-api-key: tk_xxxxxxxx..."
API standart HTTP durum kodları döner. Hata gövdesi statusCode ve message alanlarını içerir.
retryAfter kadar bekleyin.Tüm uç noktaları canlı olarak deneyebileceğiniz interaktif API referansına aşağıdan ulaşabilirsiniz.