API + Widget + Webhook'lar
Transferleri ekleyin platformunuza
Önceden rezerve edilen kara ulaşımını REST API, gömülebilir rezervasyon widget'ı ve webhook'larla web sitenize veya uygulamanıza entegre edin. Komisyon koşulları her iş ortağıyla ayrıca belirlenir.
curl -X POST https://api.youtourer.com/api/v1/transport/bookings \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Tenant-ID: YOUR_TENANT_ID" \
-d '{
"channel": "partner",
"contact_name": "Ada Example",
"contact_phone": "+90 555 000 00 00",
"passenger_count": 2,
"payment_method": "cash",
"legs": [{
"pickup": {
"lat": 41.2753, "lng": 28.7519,
"address": "Istanbul Airport (IST)"
},
"dropoff": {
"lat": 41.0054, "lng": 28.9768,
"address": "Sultanahmet"
},
"pickup_at": "2026-04-15T14:00:00Z",
"vehicle_class": "comfort"
}]
}'{ "id": "bk_a1b2c3", "status": "confirmed",
"fare": { "total_cents": 150000, "currency": "TRY" } }Üç entegrasyon yolu
Mühendislik kapasitenize ve iş ihtiyaçlarınıza uygun entegrasyon derinliğini seçin.
REST API
Tam kontrol, maksimum esneklik
Rezervasyon yaşam döngüsünü kapsayan endpoint'ler: ücret tahmini, rezervasyon oluşturma, yolculuk durumu ve mutabakat raporlama. OpenAPI 3.0 spesifikasyonu mevcut.
- Araç sınıfı dökümüyle ücret tahmini
- Çok ayaklı rezervasyon oluşturma
- Gerçek zamanlı yolculuk durumu ve şoför GPS'i
- İş ortağı rezervasyonlarında şoföre nakit ödeme
- Mutabakat raporları ve komisyon takibi
- Coğrafi çit ve bölge fiyatlandırma sorguları
Rezervasyon Widget'ı
Kopyala-yapıştır gömme, sıfır backend çalışması
Sayfanıza tek bir iframe etiketi ekleyin. Widget konum arama, ücret gösterimi, araç seçimi, ödeme tercihi ve onayı yönetir. Markanıza uyum sağlayan tamamen özelleştirilebilir renkler.
- Tek iframe — bir satır HTML
- Özel renkler, logo ve dil
- Varsayılan olarak mobil uyumlu
- Sitenizdeki widget'tan gelen rezervasyonlarda şoföre nakit ödeme
- İş ortağı API anahtarını otomatik doldurma
- Dönüşüm takibi için event callback'leri
Webhook'lar
Gerçek zamanlı olaylar, sıfır yoklama
Rezervasyon yaşam döngüsü olaylarına abone olun ve gerçek zamanlı HTTPS POST callback'leri alın. HMAC imzalı yükler özgünlüğü garanti eder. Başarısızlıkta üstel geri çekilmeli otomatik yeniden deneme.
- booking.created, booking.confirmed
- ride.assigned, ride.started, ride.completed
- payment.captured, settlement.completed
- HMAC-SHA256 imza doğrulama
- Yapılandırılabilir yeniden deneme politikası (72 saate kadar)
- Yeniden oynatma özellikli olay günlüğü
İş türünüze göre tasarlandı
İster OTA, ister otel, ister seyahat acentesi olun — iş akışınıza uygun entegrasyona sahibiz.
Online Seyahat Acenteleri
Transfer eklentileriyle AOV'yi artırın
Transferleri uçuş ve otel rezervasyonlarının yanına yerleştirin; müşterileriniz transfer seçeneğini seyahatini planlarken görsün.
Oteller ve Tatil Köyleri
İnişten lobiye misafir deneyimi
Her misafire rezervasyon onayında havalimanı transferi sunun. Otel adresini otomatik dolduran markalı rezervasyon bağlantıları.
Seyahat Acenteleri ve DMC'ler
Paketler için komple kara ulaşımı
Seyahat paketlerinize lisanslı, takipli kara ulaşımı ekleyin. Toplu rezervasyon oluşturma, grup transferleri ve çok ayaklı güzergahlar için API düzeyinde entegrasyon. Mutabakat raporları arka ofis muhasebenizle senkronize.
Ticari koşullar iş ortağı sözleşmesindedir
Komisyon, vade ve ödeme şekli talebiniz incelendikten sonra iş ortağı sözleşmesinde yazılır. Bu sayfada oran, hacim basamağı veya paket yayımlamıyoruz.
Önce görüşme
Talebiniz incelenir. Erişim ve ticari koşullar bu görüşmeden sonra, sözleşmeyle kararlaştırılır.
Komisyon sözleşmeyle
Komisyonun oranı ve hesaplanma biçimi iş ortağı sözleşmenizde yazar; tamamlanan yolculuk için hesaplanır.
Tutarlar Türk lirası
Platformdaki tutarlar Türk lirası (TRY) ile gösterilir ve hesaplanır. Kartla ödeme henüz açık değil; iş ortağı kanalındaki yolculuklarda ödeme şoföre nakit yapılabilir.
Komisyon ve ödeme koşulları iş ortağı sözleşmenizde belirlenir. Bu sayfa bir oran, gelir veya ödeme taahhüdü içermez.
Teknik özellikler
Entegrasyonunuzu planlamak için temel teknik bilgiler.
API Protokolü
REST (JSON)
Kimlik Doğrulama
Bearer Token (API Anahtarı)
Spesifikasyon
OpenAPI 3.0
Hız Limiti
1.000 istek/dk
Webhook Yeniden Deneme
Üstel (72 saat)
Ortamlar
Sandbox + Üretim
4 adımda başlayın
Hesap Oluşturun
partners.youtourer.com adresinden kaydolun. İş e-postanızı ve şirket bilgilerinizi doğrulayın.
API Anahtarlarını Alın
API anahtarları, iş ortağı başvurunuz incelendikten sonra verilir. Tam OpenAPI dokümantasyonuna erişin.
Entegre Edin ve Test Edin
Sandbox üzerinde entegrasyonunuzu oluşturun. Simüle edilmiş şoförlerle tam rezervasyon akışını test edin.
Canlıya Geçin
Üretim anahtarlarına geçin. Tamamlanan her yolculuk için iş ortağı sözleşmenize göre komisyon kazanırsınız.
İş ortağı paneliniz
Entegrasyonunuzu yönetmek, performansı izlemek ve geliri optimize etmek için ihtiyacınız olan her şey.
Analitik Paneli
Gerçek zamanlı rezervasyon sayıları, dönüşüm oranları, tarih aralığı ve araç sınıfına göre gelir. Raporlama için CSV'ye dışa aktarma.
API Keşfedici
Şimdi dene işlevselliğiyle etkileşimli API dokümantasyonu. Her endpoint'i doğrudan tarayıcınızdan test edin.
Widget Oluşturucu
Rezervasyon widget'ınız için görsel yapılandırıcı. Renkleri ve varsayılanları ayarlayın, sonucu gerçek zamanlı önizleyin. Gömme kodunu tek tıkla kopyalayın.
Webhook Yöneticisi
Endpoint'leri yapılandırın, olay türlerini seçin, teslim günlüklerini görüntüleyin ve başarısız teslimatları yeniden oynatın. Örnek yüklerle webhook'ları test edin.
Mutabakat Raporları
Rezervasyon başına detaylı komisyon dökümü. Mutabakat özetleri ve fatura indirmeleri.
Güvenlik Merkezi
API anahtarı rotasyonu, webhook gizli anahtar yönetimi ve erişim günlükleri. Rol tabanlı izinlerle OAuth 2.0 kimlik doğrulama.
Sıkça Sorulan Sorular
Canlıya geçmek ne kadar sürer?
İş ortağı hesabınız önce incelenir. Onaylandıktan sonra widget, kopyala-yapıştır bir iframe gömme kodudur; API entegrasyonunun süresi rezervasyon akışınızın karmaşıklığına bağlıdır. Canlıya geçmeden önce test için bir sandbox ortamı sağlıyoruz.
Komisyon nasıl çalışır?
Komisyonun oranı, hesaplanma biçimi ve mutabakat koşulları iş ortağı sözleşmenizde belirlenir. Bu sayfada oran yayımlamıyoruz.
Rezervasyon deneyimini beyaz etiketleyebilir miyim?
Evet. Widget özel renkler, logo ve dil destekler. Müşterileriniz sizin markanızı görür, bizimkini değil. API entegrasyonlarında tüm arayüzü siz tasarlarsınız — API'miz görünmez arka uçtur.
Test için sandbox var mı?
Evet. Her iş ortağı hesabı test API anahtarlarıyla bir sandbox ortamı içerir. Tüm endpoint'ler üretimle aynı şekilde çalışır ancak simüle edilmiş şoför dispatch ve ödeme yönetimiyle.
Hangi ödeme yöntemleri destekleniyor?
Widget yerleşiminiz veya iş ortağı API'si üzerinden yapılan rezervasyonlar şoföre nakit ödenebilir; doğrudan youtourer.com'da yapılan rezervasyonlar ise kartla önceden ödenir. Online kartla ödeme henüz açık değil; yalnızca ödeme sağlayıcısı akışı rezervasyon için hazır olduğunda gösterilir.
Hangi para birimi kullanılıyor?
Platformdaki tutarlar Türk lirası (TRY) ile hesaplanır ve gösterilir; mutabakat da TRY cinsindendir. Diğer para birimleri bugün sunulmuyor.
İŞ ORTAKLIĞI GÖRÜŞMESİ
İş ortaklığı için bizimle konuşun
Kim olduğunuzu ve Youtourer ile nasıl çalışmak istediğinizi yazın. İş ortaklıkları ekibi her talebi okur ve e-posta ile yanıtlar. Buraya yolcu bilgisi veya kimlik belgesi göndermeyin.
Bu bir görüşme talebidir; hesap, API erişimi, plan veya teklif oluşturmaz. Erişim ve ticari koşullar, inceleme sonrasında ayrıca kararlaştırılır.
Filo mu işletiyorsunuz? Bunun yerine operatör başvurusu gönderin.
Bu form henüz açık değil
Şu anda iş ortaklığı taleplerini bu form üzerinden almıyoruz. İş ortaklıkları ekibiyle görüşmek için şu adrese yazın: partners@youtourer.com
Platformunuza transfer ekleyin
İş ortağı hesabı için başvurun. Hesabınız onaylandığında API anahtarlarınızı alır, widget'ı kopyala-yapıştır ile sitenize eklersiniz.
İş ortaklığı talepleri: [email protected]