İçeriğe geç
Blog

Seyahat API karşılaştırması: tedarikçiyi değil ekseni puanlayın

Tekravel Editöryal
Yapay zekânın yardımıyla yazıldı

Üç sekmede üç tedarikçinin sunumu açık. Her birinde uzun bir havayolu listesi, bir otel sayısı, bir sandbox, REST ve JSON, bir de destek e-postası var. Bir tablo kuruyorsunuz, her hücreye tik atıyorsunuz ve tablo berabere bitiyor. Özellik listesiyle yapılan bir seyahat API karşılaştırmasının olağan sonu budur ve yanlış bir sondur; çünkü önümüzdeki yılınızı belirleyecek farklar ancak canlıya geçtikten sonra ortaya çıkar: tedarikçide başarılı olup sizin tarafınızda zaman aşımına düşen rezervasyonda, kimsenin işleyemediği iadede, listede olan ama bu kanaldan bileti kesilemeyen havayolunda.

Bu yazı, bu kararı verecek ve sonra savunacak geliştirici ya da teknik lider için. Tedarikçileri sıralamıyor. Size karşılaştırma eksenleri, zamanını hata senaryolarına harcayan bir deneme planı ve gerçek bir tedarikçiyle mi yoksa başkasının tedarikçisini yeniden satan biriyle mi konuştuğunuzu hızla gösteren birkaç soru veriyor.

Özellik listesi neden hep berabere biter

Bir kontrol listesi bir yeteneğin var olup olmadığını sorar. Neredeyse her seyahat API'si neredeyse her satıra evet diyebilir, çünkü satırlar pazarlama sayfasının dilinde yazılmıştır: arama, fiyatlama, rezervasyon, iptal, biletleme, webhook, sandbox. Onları ayıran soru cancel çağrısının var olup olmadığı değil; kalkıştan on iki saat önce, cezalı bir tarifede, içeriği üçüncü bir taraftan gelen bir kanalda biletlenmiş bir rezervasyonda onu çağırdığınızda ne olduğudur. Listede bunun için sütun yoktur.

İkinci bir sorun daha var. Listeyi dolduran genellikle tedarikçinin kendisidir. Siz onun kendini tanımlamasını puanlıyorsunuz.

Tedarikçiye değil eksenlere dayalı bir seyahat API karşılaştırması

Tedarikçi-özellik tablosunun yerine, denemede topladığınız kanıtlara göre kendinizin puanladığı eksenleri koyun. Aşağıdaki tablo bizim kullanacağımız tablo. Satırlara farklı ağırlık verebilirsiniz — yalnızca otel satan bir işletme biletlemeyi daha az önemser — ve benimsemeden önce onunla tartışmalısınız.

EksenKontrol listesinin sorduğuGerçekte öğrenmeniz gerekenZayıf cevap nasıl duyulur
KapsamKaç havayolu, kaç otel?Bunlardan kaçı sizin pazarlarınızda bu API üzerinden aranabiliyor, rezerve edilebiliyor VE biletlenebiliyor ya da onaylanabiliyorAyrıntısı olmayan tek bir büyük sayı
Derinlikİptal uç noktası var mı?Her içerik kaynağı için hangi satış sonrası işlemler otomatik: void, iade, yeniden düzenleme, isim düzeltme, ek hizmetler"Bunu operasyon ekibimiz hallediyor"
Fiyat tutarlılığıFiyatlar anlık mı?Rezervasyondaki fiyat aramadakinden ne sıklıkla farklı ve API bunu size nasıl söylüyor"Fiyatlar her zaman canlı"
Hata anlamıHatalar belgelenmiş mi?Hatanın yalnızca bir şeyin başarısız olduğunu değil, rezervasyonun hangi durumda olduğunu söyleyip söylemediğiHer hata için tek bir genel kod
Idempotency—Tekrarlanan bir rezervasyon çağrısının ikinci bir rezervasyon yaratıp yaratamayacağıSessizlik, sonra "bunu hiç görmedik"
Kayıtlı tedarikçi—Kimin sözleşmesi, kimin IATA numarası, bilet hangi BSP üzerinden kesiliyor"Tüm büyük GDS'lerle çalışıyoruz"
Erişim ve destekSandbox var mı?Canlı bir PNR takıldığında kim cevap veriyor ve ne kadar hızlıBir destek formu, isimli bir muhatap yok

Bu satırların ikisinin kontrol listesinde hiç karşılığı yok. Bu tesadüf değil: yanlış gittiklerinde en pahalıya patlayan ve bir tedarikçi sunumunun kendiliğinden en az söyleyeceği satırlar onlar.

Kapsam derinlik değildir

Havayolu listesi her sunumun en yanıltıcı slaytıdır. Yüzlerce taşıyıcıdan oluşan bir liste birkaç farklı anlama gelebilir ve bunlardan yalnızca biri sizin istediğinizdir.

Bu taşıyıcıların bir kısmı GDS üzerinden gelir ve uçtan uca rezerve edilip biletlenebilir. Bir kısmı NDC bağlantılarıyla gelir; arama iyi çalışabilir ama rezervasyon sonrası hizmetler — değişiklik, kısmi iade, bagaj ekleme — o havayolu için hâlâ manuel olabilir. Bir kısmı, içeriği başka bir satıcıdan toplanan düşük maliyetli taşıyıcılardır; onları gösterebilir, bazen rezerve edebilirsiniz, sonra bilet kontrol etmediğiniz bir yoldan, müşterinize söz veremeyeceğiniz bir sürede gelir. Ve bir kısmı listede, çünkü bir zamanlar bir arama yanıtında bir tarife dönmüştür.

Gösterebildiğiniz ama biletleyemediğiniz bir taşıyıcı kapsam değildir. Perakende bir üründe yokluğundan daha kötüdür, çünkü müşteri onu seçer, öder ve sonra bekler.

Oteller aynı şekle başka kelimelerle sahiptir. Tesis sayısı tedarikçinin eşleştirdiği (mapping) ve eşleştirmediği tesisleri; geçen hafta önbelleğe alınmış statik fiyatları canlı müsaitliğin yanında; release süresi olan allotment odalarını free-sale envanterin yanında içerir. Sattığınız şehirlerde canlı rezerve edilebilen sayıyı isteyin ve kendi tedarikçileri arasındaki tekrarların nasıl birleştirildiğini sorun — aynı otelin üç farklı fiyatla üç kez görünmesi, sırasını bekleyen bir destek talebidir.

Pratik test dardır. Hacminizin çoğunu oluşturan yirmi rotayı ve yirmi otel şehrini yazın — İstanbul–Antalya, İstanbul–Dubai, Ankara–Bakü gibi — ve tedarikçiden tam olarak bunları sandbox'ta uçtan uca çalışırken göstermesini isteyin: arama, fiyat, rezervasyon, biletleme ya da onay, iptal. Derinliği olan tedarikçi bunu sorunsuz yapar. Yalnızca slaytı olan tedarikçi slayttan bahsetmeye başlar.

Denemede ne test edilmeli: mutlu yollar değil, hata yolları

Her sandbox, sakin bir rotada tek yön ekonomi bileti başarıyla rezerve eder. Sandbox tam da bunu göstermek için kurulmuştur. Gerçek trafiğiniz ise ömrünün kayda değer bir kısmını diğer yollarda geçirecek ve deneme, onları görmenin tek ucuz anıdır.

Denemeyi bu listeyi çalıştırmak için kullanın ve API'nin ne döndürdüğünü, sonrasında gerçekte neyin doğru olduğuyla yan yana kaydedin:

  • Arama ile rezervasyon arasında fiyat değişimi. Rezervasyon çağrısı başarısız mı oluyor, yeni fiyatla mı başarılı oluyor, yoksa onay isteyen ayrı bir yanıt mı dönüyor? Arayüzünüz bir mesaj metnini ayrıştırmadan farkı anlayabiliyor mu?
  • Süresi dolmuş teklif. Arayın, tedarikçinin teklif ömründen uzun bekleyin, sonra rezerve edin. Süre dolumu belirli bir hata mı, yoksa "tedarikçi kapalı" ile aynı hata mı?
  • Rezervasyon anında tükenme. Fiyatlama ile rezervasyon arasında kaybolan envanter. Rezervasyon hangi durumda ve ödeme provizyonu serbest bırakılıyor mu?
  • Zaman aşımından sonra tekrar deneme. Bir rezervasyon isteği gönderin, yanıttan önce bağlantıyı kesin, sonra tekrar gönderin. Şimdi bir PNR'niz mi var, iki mi? Bu tek test, tedarikçi hakkında denemenin geri kalanının toplamından fazlasını söyler.
  • Rezervasyon oluştu, biletleme başarısız. API var olan ama biletlenmemiş bir PNR'yi raporlayabiliyor mu ve size biletleme son tarihini söylüyor mu?
  • Kısmi başarısızlık. Bir odası onaylanan, diğeri onaylanmayan çok odalı otel talebi. Gidiş ve dönüşü farklı kaynaklardan gelen gidiş-dönüş.
  • Ücretsiz pencere dışında iptal. Ceza onaylamadan önce mi gösteriliyor, yoksa faturada mı fark ediliyor?
  • Tedarikçi kesintisi. Tedarikçiye bunu nasıl simüle edeceğinizi sorun. Edemiyorsa, müşterilerinin bu davranışı nasıl öğrendiğini sorun.

Her durumda iki şeyi puanlıyorsunuz. Birincisi, API size rezervasyonun durumu hakkında doğruyu söylüyor mu? İkincisi, kodunuz bir insanın serbest metin okumasına gerek kalmadan bu doğruya göre hareket edebiliyor mu? Açıkça başarısız olan bir API, belirsizce başarılı olan bir API'den daha kolay yaşanır.

Bunun uçuş tarafını uçuş rezervasyon API entegrasyonunda dokümanın anlatmadıkları yazısında, yavaş otel tedarikçileri için istemci tasarımını da otel müsaitlik yazısında daha ayrıntılı ele aldık. İkisi de bir deneme planına iyi eşlik eder.

Zayıf bir toplayıcıyı ele veren sorular

Toplayıcıda (aggregator) bir sorun yok. Seyahat içeriğinin çoğu satıcılara çoğunlukla bir toplayıcı üzerinden ulaşır. Risk zayıf olandadır: başka bir katmanın API'sini yeniden satan, marj ekleyen, ne tedarikçi sözleşmesine ne de operasyon masasına sahip olan bir katman. Bir şey bozulduğunda cevabın iki şirket yukarı gidip geri gelmesi gerekir.

Beş soru bunu hızla ortaya çıkarır:

  1. Bu rezervasyonun kayıtlı tedarikçisi kim? Havayolu ya da otelle kimin sözleşmesine dayanıyor?
  2. Bilet kimin IATA numarası ve hangi BSP üzerinden kesiliyor? Cevap "bir ortağın" ise, bir tarife kuralı çiğnendiğinde ADM'yi kimin aldığını sorun.
  3. İptal çağırdığımda sizin tarafınızda ne oluyor? Tedarikçiye otomatik bir çağrı mı, yoksa bir kişinin aldığı bir kuyruk mu?
  4. Kaynaktan gelen hatayı görebilir miyim? Zayıf bir katman her başarısızlığı tek bir koda indirgeme eğilimindedir, çünkü aldığı hataları tam olarak anlamaz.
  5. Takılan canlı bir rezervasyon için kimi arıyorum, o kimi arıyor? Halkaları sayın.

Bu cevapların hiçbiri tek başına eleyici değildir. Sözleşme borç dekontunu kimin taşıyacağını açıkça söylüyorsa, bir ortağın IATA numarası sorun olmayabilir. Önemli olan tedarikçinin net ve hızlı cevap vermesidir. Burada aldığınız belirsiz cevaplar, daha sonra canlı ortamda ve daha kötü bir saatte alacağınız cevaplardır.

Yanlış seçimin size maliyeti

Entegrasyon ucuz kısımdır. Pahalı kısımlar sonra gelir ve hiçbir tahminde görünmez.

Mükerrer rezervasyon hatası, iki kez tahsilat yapılmış bir müşteri ve elle bulup iptal etmeniz gereken bir PNR demektir; belki de ücretsiz void penceresi kapandıktan sonra. Kaynakta başarılı olup sizin tarafınızda başarısız kaydedilen bir rezervasyon, tutulan, sonra otomatik iptal edilen bir koltuk ve rezervasyonunun yapıldığına inanan bir müşteri demektir. Gösterip biletleyemediğiniz bir taşıyıcı; bir iade, bir özür ve geri dönmeyen bir müşteri demektir. Tedarikçinin kanalının çiğnediği bir tarife kuralı için gelen ADM, bilete sahip olanın üzerine düşer — bunun siz olup olmadığınızı önceden bilin.

Bir de geçiş maliyeti var. Emdiğiniz her tedarikçi tuhaflığı — iki anlama gelen bir durum kodu, bazen metin olan bir alan — veri modelinize yerleşir. İki yıl sonra API seçimi bir sprintte değiştirebileceğiniz bir entegrasyon olmaktan çıkar; rezervasyon tablonuzun şekli olur. Şimdi dikkatle karşılaştırmanın asıl nedeni budur.

Kendi API'mizin bu çerçevedeki yeri

Uçuş ve otel API'leri sunuyoruz. Erişim bir self-servis anahtarla değil, bir görüşmeyle başlar; bazı geliştiriciler bunu yavaş bulur. Nedeni, yukarıdaki soruların iki yönde de sorulduğu yerin o görüşme olmasıdır — hangi rotalara ve şehirlere ihtiyacınız var, hangi içeriği gerçekten biletleyebilecek ya da onaylayabileceksiniz, rezervasyondan sonra neyi kim üstleniyor. Bir karşılaştırma yapıyorsanız bu listeyi yanınızda getirin. Seyahat API'leri sayfası o görüşmenin başladığı yer.

Ne seçerseniz seçin, sunumdan değil deneme kaydından seçin. Sunum size tedarikçinin ne olmak istediğini söyler. Hata yolları ise ne olduğunu.

Tekravel Editöryal

Seyahat teknolojisi masası

Tekravel seyahat teknolojisi masası sektör için yazar: acente sahipleri, konsolidatörler ve onları entegre eden geliştiriciler. Her yazı, yayımlanmadan önce anlattığı platform üzerinde doğrulanır.