TRANSFERISE PARTNER API · V1 · REFERANS
Havalimanı transfer API dokümantasyonu
Tek bir JSON API ile yer arayın, canlı fiyat alın, özel havalimanı transferlerini oluşturun, değiştirin ve iptal edin. Aşağıdaki her isteğin sağında çağrının kendisi ve tam olarak ne döndüğü görünür. Ücretsiz sandbox anahtarıyla geliştirin; canlıya geçene kadar hiçbir şey sürücülere veya ödemelere ulaşmaz.
Hızlı başlangıç
Üç çağrı, yolcuyu "nereye?" sorusundan rezerve edilmiş bir transfere götürür.
- 1Yerleri bulun
places, "AYT" ya da bir otel adını yer kimliğine çevirir. - 2Canlı fiyatları gösterin
quoteher aracı kesin fiyatıyla döndürür. - 3Rezerve edin
bookrezervasyonu ve gerekiyorsa güvenli kart ödeme linkini oluşturur.
Kimlik doğrulama ve sandbox
Anahtarınızı X-Api-Key başlığında gönderin. Tüm istek ve yanıtlar JSON (UTF-8) formatındadır.
- Base URL
https://transferise.com/api/widget.php?action=…- Sandbox anahtarı
tfx_test_…. Canlıyla aynı yerler, fiyatlar ve kontroller. RezervasyonlarTEST-…olur ve sadece siz görürsünüz. Sürücü, ödeme ya da e-posta yok.- Canlı anahtar
tfx_…. Partner panelinde kısa bir incelemeden sonra verilir. Alan adlarınıza kilitlenebilir.- Güvenlik
book,updatevecancelçağrılarını tarayıcıdan değil, sunucunuzdan yapın. Canlı anahtarı asla istemci koduna veya herkese açık bir depoya koymayın.
curl 'https://transferise.com/api/widget.php?action=places&q=antalya' \
-H 'X-Api-Key: tfx_test_…' {
"ok": false,
"error": "invalid_api_key",
"docs": "https://transferise.com/developers/docs"
}Rezervasyon akışı
Bir rezervasyon bu durumlardan geçer. booking her zaman güncel olanı döndürür.
payment_url üzerinden ödercancelled, iptal süresi kapanana kadar tek bir ayak ya da tüm rezervasyon için olabilir.
?action=placesYer arama
Havalimanı, otel, tatil yeri veya adres bulun. Dönen id değerini quote ve book çağrılarında kullanın.
| Parametre | Tür | |
|---|---|---|
qzorunlu | string | Arama metni, en az 2 karakter |
- Sadece okuma. Hiçbir şey kaydedilmez.
- Koordinatlarıyla birlikte en fazla 10 sonuç döner.
- Listemizde olmayan yerler de
from_lat / from_lng / from_labelile rezerve edilebilir.
curl 'https://transferise.com/api/widget.php?action=places&q=rixos+downtown' \
-H 'X-Api-Key: tfx_test_…'const res = await fetch(
'https://transferise.com/api/widget.php?action=places&q=rixos+downtown',
{ headers: { 'X-Api-Key': process.env.TRANSFERISE_KEY } }
);
const data = await res.json();$ch = curl_init('https://transferise.com/api/widget.php?action=places&q=rixos+downtown');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY')],
]);
$data = json_decode(curl_exec($ch), true); {
"ok": true,
"results": [
{
"id": "hotel:17370",
"kind": "hotel",
"name": "Rixos Downtown Antalya",
"label": "Rixos Downtown Antalya, Antalya City, Antalya, Türkiye",
"iata": null,
"lat": 36.8774,
"lng": 30.6656
}
]
}?action=quoteCanlı fiyat alma
Bir yolculuk için araçlar ve fiyatlar. Fiyatlar kesindir; pricing değeri per_person değilse araç başınadır.
| Parametre | Tür | |
|---|---|---|
from, tozorunlu | place id | places sonucundan, ör. airport:68. Ya da from_lat, from_lng, from_label kullanın. |
date, timezorunlu | YYYY-MM-DD, HH:MM | Yerel alış saati |
passengers | int | 1–30, varsayılan 2 |
round, return_date, return_time | 1 + date/time | Gidiş-dönüş |
currency | EUR · GBP · USD · TRY … | Varsayılan EUR |
lang | en · tr · de · ru | İsimlerin ve linklerin dili |
- Fiyatlar web sitemizle aynı kurallarla hesaplanır. Rezervasyon yapılmaz.
payment_methods, yolcunun her araç için kullanabileceği ödeme yöntemlerini listeler.booking_urlödeme sayfamızı sizin partner kodunuzla açar. 30 gün içindeki rezervasyonlar size yazılır.
curl 'https://transferise.com/api/widget.php?action=quote&from=airport%3A68&to=hotel%3A17370&date=2026-12-02&time=14%3A00&passengers=2¤cy=GBP' \
-H 'X-Api-Key: tfx_test_…'const res = await fetch(
'https://transferise.com/api/widget.php?action=quote&from=airport%3A68&to=hotel%3A17370&date=2026-12-02&time=14%3A00&passengers=2¤cy=GBP',
{ headers: { 'X-Api-Key': process.env.TRANSFERISE_KEY } }
);
const data = await res.json();$ch = curl_init('https://transferise.com/api/widget.php?action=quote&from=airport%3A68&to=hotel%3A17370&date=2026-12-02&time=14%3A00&passengers=2¤cy=GBP');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY')],
]);
$data = json_decode(curl_exec($ch), true); {
"ok": true,
"test": false,
"from": "Antalya Airport (AYT)",
"to": "Rixos Downtown Antalya",
"date": "2026-12-02",
"time": "14:00",
"passengers": 2,
"round_trip": false,
"vehicles": [
{
"id": 60,
"name": "Standard Sedan",
"type": "private",
"pricing": "per_vehicle",
"max_passengers": 3,
"max_luggage": 3,
"price": 25.04,
"currency": "GBP",
"price_eur": 30,
"payment_methods": [
"iyzico_full"
]
}
],
"booking_url": "https://transferise.com/search?from=…&ref=p12&utm_source=partner&utm_medium=widget&utm_content=api"
}?action=bookRezervasyon oluşturma
Güncel bir fiyat sorgusundaki aracı rezerve edin. Asgari süre ve güzergâh kontrolleri web sitemizle aynıdır.
| Parametre | Tür | |
|---|---|---|
vehicle_idzorunlu | int | quote sonucundan |
from, to, date, timezorunlu | quote ile aynı | |
customerzorunlu | object | first_name, last_name, email, phone |
adults, children, infants | int | Yolcu dağılımı |
round_trip, return_date, return_time | Gidiş-dönüş | |
flight_number, hotel, notes | string | Sürücüye yardımcı olur |
payment_method | string | quote yanıtındaki payment_methods değerlerinden biri |
partner_reference | string ≤ 64 | Kendi kimliğiniz. Tekrar gönderilirse mevcut rezervasyon döner. |
- Kendi
referencedeğeri olan bir rezervasyon oluşur. Sandbox anahtarıyla bu, sadece sizin görebildiğiniz birTEST-…rezervasyonudur. - API rezervasyonları şu an tamamen kartla ödenir. Yolcu
payment_urlsayfasında (3-D Secure) ödeyene kadar durumpending_paymentkalır, sonraconfirmedolur. - Yolcuya onay e-postamız gider. Operasyon ekibimiz sürücüyü atar.
- Aynı
partner_referenceile tekrar denemek asla ikinci rezervasyon oluşturmaz.
curl -X POST 'https://transferise.com/api/widget.php?action=book' \
-H 'X-Api-Key: tfx_test_…' \
-H 'Content-Type: application/json' \
-d '{"vehicle_id":60,"from":"airport:68","to":"hotel:17370","date":"2026-12-02","time":"14:00","round_trip":true,"return_date":"2026-12-09","return_time":"10:00","adults":2,"currency":"GBP","lang":"en","customer":{"first_name":"Anna","last_name":"Smith","email":"anna@example.com","phone":"+447700900123"},"flight_number":"TK123","payment_method":"iyzico_full","partner_reference":"ARF-1001"}'const res = await fetch('https://transferise.com/api/widget.php?action=book', {
method: 'POST',
headers: {
'X-Api-Key': process.env.TRANSFERISE_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"vehicle_id": 60,
"from": "airport:68",
"to": "hotel:17370",
"date": "2026-12-02",
"time": "14:00",
"round_trip": true,
"return_date": "2026-12-09",
"return_time": "10:00",
"adults": 2,
"currency": "GBP",
"lang": "en",
"customer": {
"first_name": "Anna",
"last_name": "Smith",
"email": "anna@example.com",
"phone": "+447700900123"
},
"flight_number": "TK123",
"payment_method": "iyzico_full",
"partner_reference": "ARF-1001"
}),
});
const data = await res.json();$ch = curl_init('https://transferise.com/api/widget.php?action=book');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'vehicle_id' => 60,
'from' => 'airport:68',
'to' => 'hotel:17370',
'date' => '2026-12-02',
'time' => '14:00',
'round_trip' => true,
'return_date' => '2026-12-09',
'return_time' => '10:00',
'adults' => 2,
'currency' => 'GBP',
'lang' => 'en',
'customer' => [
'first_name' => 'Anna',
'last_name' => 'Smith',
'email' => 'anna@example.com',
'phone' => '+447700900123',
],
'flight_number' => 'TK123',
'payment_method' => 'iyzico_full',
'partner_reference' => 'ARF-1001',
]),
]);
$data = json_decode(curl_exec($ch), true); {
"ok": true,
"booking": {
"reference": "TRS-7F3A21C",
"status": "pending_payment",
"payment_method": "iyzico_full",
"payment_status": "pending",
"total": 50.08,
"currency": "GBP",
"vehicle": {
"id": 60,
"name": "Standard Sedan"
},
"round_trip": true,
"passengers": {
"adults": 2,
"children": 0,
"infants": 0,
"total": 2
},
"customer": {
"first_name": "Anna",
"last_name": "Smith",
"email": "anna@example.com",
"phone": "+447700900123"
},
"notes": "",
"legs": [
{
"id": 9812,
"type": "outbound",
"status": "confirmed",
"from": "Antalya Airport (AYT)",
"to": "Rixos Downtown Antalya",
"pickup_date": "2026-12-02",
"pickup_time": "14:00",
"flight_number": "TK123",
"hotel": "",
"can_modify": true,
"hours_until_pickup": 331.5
},
{
"id": 9813,
"type": "return",
"status": "confirmed",
"from": "Rixos Downtown Antalya",
"to": "Antalya Airport (AYT)",
"pickup_date": "2026-12-09",
"pickup_time": "10:00",
"flight_number": "",
"hotel": "",
"can_modify": true,
"hours_until_pickup": 499.5
}
],
"payment_url": "https://transferise.com/payment/iyzico/TRS-7F3A21C",
"manage_url": "https://transferise.com/my-booking",
"partner_reference": "ARF-1001",
"test": false
}
}?action=bookingRezervasyon sorgulama
Oluşturduğunuz bir rezervasyon; her ayağın (gidiş ve dönüş) güncel durumuyla.
| Parametre | Tür | |
|---|---|---|
referencezorunlu | string | Ya da partner_reference |
- Sadece okuma. Hiçbir şey kaydedilmez.
- Her ayakta
status,can_modifyvehours_until_pickupgörünür. - Durum değişikliklerini izlemek için bunu düzenli sorgulayın ya da Supabase kitinin senkronunu kullanın.
curl 'https://transferise.com/api/widget.php?action=booking&reference=TRS-7F3A21C' \
-H 'X-Api-Key: tfx_test_…'const res = await fetch(
'https://transferise.com/api/widget.php?action=booking&reference=TRS-7F3A21C',
{ headers: { 'X-Api-Key': process.env.TRANSFERISE_KEY } }
);
const data = await res.json();$ch = curl_init('https://transferise.com/api/widget.php?action=booking&reference=TRS-7F3A21C');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY')],
]);
$data = json_decode(curl_exec($ch), true); { "ok": true, "booking": { … same shape as book … } }?action=bookingsRezervasyonları listeleme
Rezervasyonlarınız alış tarihine göre, sayfa başına 50 adet.
| Parametre | Tür | |
|---|---|---|
from, to | YYYY-MM-DD | Varsayılan −30 / +365 gün |
page | int | Varsayılan 1 |
- Sadece okuma. Hiçbir şey kaydedilmez.
- Sadece sizin anahtarlarınızla yapılan rezervasyonlar listelenir.
curl 'https://transferise.com/api/widget.php?action=bookings&from=2026-11-01&to=2027-01-31' \
-H 'X-Api-Key: tfx_test_…'const res = await fetch(
'https://transferise.com/api/widget.php?action=bookings&from=2026-11-01&to=2027-01-31',
{ headers: { 'X-Api-Key': process.env.TRANSFERISE_KEY } }
);
const data = await res.json();$ch = curl_init('https://transferise.com/api/widget.php?action=bookings&from=2026-11-01&to=2027-01-31');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY')],
]);
$data = json_decode(curl_exec($ch), true); { "ok": true, "page": 1, "per_page": 50, "bookings": [ … ] }?action=updateRezervasyon değiştirme
Bir ayağın alış tarihini ya da saatini, uçuş numarasını, otelini veya notlarını değiştirin.
| Parametre | Tür | |
|---|---|---|
referencezorunlu | string | Ya da partner_reference |
leg_id | int | Varsayılan: gidiş ayağı |
pickup_date, pickup_time, flight_number, hotel, notes | Değişecek alanlar |
- Ayak hemen güncellenir.
- Yolcu, sürücü ve ekibimiz otomatik bilgilendirilir.
- Değişiklik süresi kapanana kadar yapılabilir (varsayılan olarak alıştan 24 saat önce). Sonrasında
409 not_modifiabledöner.
curl -X POST 'https://transferise.com/api/widget.php?action=update' \
-H 'X-Api-Key: tfx_test_…' \
-H 'Content-Type: application/json' \
-d '{"reference":"TRS-7F3A21C","leg_id":9812,"pickup_time":"15:30","flight_number":"TK999"}'const res = await fetch('https://transferise.com/api/widget.php?action=update', {
method: 'POST',
headers: {
'X-Api-Key': process.env.TRANSFERISE_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"reference": "TRS-7F3A21C",
"leg_id": 9812,
"pickup_time": "15:30",
"flight_number": "TK999"
}),
});
const data = await res.json();$ch = curl_init('https://transferise.com/api/widget.php?action=update');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'reference' => 'TRS-7F3A21C',
'leg_id' => 9812,
'pickup_time' => '15:30',
'flight_number' => 'TK999',
]),
]);
$data = json_decode(curl_exec($ch), true); { "ok": true, "booking": { … } }?action=cancelRezervasyon iptali
Tek bir ayağı (leg_id) ya da tüm rezervasyonu (leg_id olmadan) iptal edin.
| Parametre | Tür | |
|---|---|---|
referencezorunlu | string | Ya da partner_reference |
leg_id | int | Sadece bu ayağı iptal eder |
- Ayak ya da rezervasyon
cancelledolur ve sürücü serbest kalır. - İptal süresi kapanana kadar ücretsizdir. Kart ödemeleri iade politikamıza göre iade edilir.
- Yolcu bilgilendirilir.
curl -X POST 'https://transferise.com/api/widget.php?action=cancel' \
-H 'X-Api-Key: tfx_test_…' \
-H 'Content-Type: application/json' \
-d '{"reference":"TRS-7F3A21C"}'const res = await fetch('https://transferise.com/api/widget.php?action=cancel', {
method: 'POST',
headers: {
'X-Api-Key': process.env.TRANSFERISE_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"reference": "TRS-7F3A21C"
}),
});
const data = await res.json();$ch = curl_init('https://transferise.com/api/widget.php?action=cancel');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('TRANSFERISE_KEY'), 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'reference' => 'TRS-7F3A21C',
]),
]);
$data = json_decode(curl_exec($ch), true); { "ok": true, "booking": { "status": "cancelled", … } }Transferise for Supabase
Supabase üzerinde çalışan her uygulamaya havalimanı transferi ekleyen açık kaynak bir kit (MIT). Rezervasyonları Row Level Security ile kendi Supabase veritabanınızda tutar ve her durum değişikliğini Supabase Realtime ile uygulamanıza iletir. Ayrı bir rezervasyon altyapısı kurmanız gerekmez.
Rezervasyonlar sizin veritabanınızda
Bir migration, transferise_bookings ve bir durum geçmişi tablosu oluşturur. Diğer tablolar gibi sorgulayabilirsiniz.
Canlı durum
Zamanlanmış bir fonksiyon açık rezervasyonları günceller. Realtime, confirmed → assigned → completed değişikliklerini oturum açmış sahibine iletir.
Varsayılan olarak güvenli
RLS sayesinde kullanıcılar sadece kendi satırlarını okur, tarayıcıdan kimse yazamaz. API anahtarı Edge Function gizli değeri olarak kalır. Yolcu e-postası ve telefonu saklanmaz.
1. Kurulum
Bir sandbox anahtarı alın, migration'ı uygulayın, gizli değerleri girin ve iki fonksiyonu yayınlayın.
- Projenize RLS, tetikleyiciler ve Realtime ile iki tablo eklenir.
transferise(JWT gerekir) vetransferise-sync(ortak gizli anahtar) yayınlanır.- Anahtarınız yalnızca fonksiyonun gizli değeri olarak saklanır.
supabase link --project-ref <project-ref>
supabase db push
supabase secrets set \
TRANSFERISE_API_KEY=tfx_test_xxx \
SYNC_SECRET=$(openssl rand -hex 24)
supabase functions deploy transferise
supabase functions deploy transferise-sync --no-verify-jwt Applying migration 20261113000000_transferise.sql...
Finished supabase db push.
Finished supabase secrets set.
Deployed Functions: transferise, transferise-sync2. Uygulamanızdan fiyat alın ve rezerve edin
Edge Function'ı supabase.functions.invoke ile çağırın. Oturum açmış kullanıcı rezervasyonun sahibi olur.
- Fonksiyon kullanıcının JWT'sini doğrular ve Transferise API'sini gizli anahtarınızla çağırır.
transferise_bookingstablosuna referans, güzergâh, saat, fiyat ve durumla bir satır yazılır.- Rezervasyon kartla ödeme gerektiriyorsa yolcu için
payment_urldöner.
const { data: quote } = await supabase.functions.invoke('transferise', {
body: { action: 'quote', from: 'airport:68', to: 'hotel:17370',
date: '2026-12-02', time: '14:00', passengers: 2 },
});
const { data } = await supabase.functions.invoke('transferise', {
body: {
action: 'book', from: 'airport:68', to: 'hotel:17370',
date: '2026-12-02', time: '14:00', passengers: 2,
vehicle_id: quote.vehicles[0].id, flight_number: 'TK123',
customer: { first_name: 'Anna', last_name: 'Smith',
email: 'anna@example.com', phone: '+447700900123' },
},
});
if (data.booking.payment_url) location.href = data.booking.payment_url; {
"booking": {
"id": "7b1c…",
"reference": "TRS-7F3A21C",
"status": "pending_payment",
"from_label": "Antalya Airport (AYT)",
"to_label": "Rixos Downtown Antalya",
"pickup_date": "2026-12-02",
"pickup_time": "14:00:00",
"total": 25.04,
"currency": "GBP",
"payment_url": "https://transferise.com/payment/iyzico/TRS-7F3A21C"
}
}3. Canlı durumu gösterin
Değişikliklere abone olun. RLS her kullanıcının sadece kendi rezervasyonlarını almasını sağlar.
transferise-syncpg_cron ile 5 dakikada bir çalışır ve açık rezervasyonları günceller.- Her durum değişikliği tabloya ve
transferise_booking_eventstablosuna yazılır. - Realtime güncellemeyi tarayıcıya iletir. Uygulamanızda sürekli sorgu gerekmez.
supabase
.channel('my-transfers')
.on('postgres_changes',
{ event: 'UPDATE', schema: 'public', table: 'transferise_bookings' },
(p) => updateCard(p.new.reference, p.new.status))
.subscribe(); {
"eventType": "UPDATE",
"table": "transferise_bookings",
"old": {
"status": "confirmed"
},
"new": {
"reference": "TRS-7F3A21C",
"status": "assigned",
"pickup_date": "2026-12-02",
"pickup_time": "14:00:00"
}
}supabase/migrations/…_transferise.sqltables, triggers, RLS, Realtimesupabase/functions/transferise/places · quote · book · status · cancelsupabase/functions/transferise-sync/status syncsupabase/cron.sqlpg_cron + Vaulttests/SQL/RLS, unit, sandbox
Hatalar
Hatalar bir HTTP durum koduyla {"ok": false, "error": "…"} döndürür. Bazılarında okunabilir bir message da bulunur.
| HTTP | error | Anlamı |
|---|---|---|
| 401 | invalid_api_key | Anahtar yok ya da yanlış, veya istek canlı anahtarın kilitli olmadığı bir alan adından geliyor. |
| 400 | from_to_required · reference_required · q_too_short | Zorunlu bir parametre eksik. |
| 404 | booking_not_found · leg_not_found | Size ait bir rezervasyon değil ya da ayak kimliği yanlış. |
| 405 | use_post | book, update ve cancel için POST gerekir. |
| 409 | not_modifiable · already_cancelled | Değişiklik ya da iptal süresi kapandı veya rezervasyon zaten iptal. |
| 422 | booking_rejected | message nedenini açıklar: fiyat değişti (tekrar quote yapın), süre çok kısa, iletişim bilgisi eksik… |
| 429 | rate_limited | Anahtar başına dakikada 120 istek; canlı anahtar başına saatte 30 rezervasyon. |
Rezervasyon kuralları
- Ödeme:
cash_driver(sürücüye ödeme),iyzico_split(kartla ön ödeme, kalanı nakit),iyzico_full(tamamı kartla). Sadece quote yanıtındakipayment_methodskabul edilir. API rezervasyonları şu aniyzico_fullkullanır. - Değişiklik ve iptal: süre kapanana kadar ücretsiz (varsayılan olarak her alıştan 24 saat önce). Sonrasında
manage_urlkullanın ya da destekle iletişime geçin. - Yolcu iletişimi: yolcu, sürücü bilgileri ve Rezervasyonum linkiyle onay e-postamızı alır. API ile yapılan değişiklikler yolcuya ve sürücüye bildirilir.
- Atıf: anahtarınızla yapılan rezervasyonlar ve yolcunun
booking_urllinkinizi açmasından sonraki 30 gün içindeki rezervasyonlar partner kodunuzu taşır. - Adil kullanım: Kabul Edilebilir Kullanım Politikası
Geliştirmeye hazır mısınız?
Dakikalar içinde sandbox anahtarı alın ve ilk rezervasyonunuzu bugün yapın. Canlı anahtarlar kısa bir incelemeden sonra verilir.
