İçeriğe geç
Blog

Uçuş rezervasyon API entegrasyonu: dokümanın anlatmadıkları

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

Panodaki iş kartı kısaca "uçuşları ekle" diyor. Daha önce bir ödeme entegrasyonu, belki bir kargo ücreti ya da harita entegrasyonu yaptınız ve aklınızdaki model belli: ara, sonuçları göster, kartı çek, bitti. Sonra ilk gerçek rezervasyon, sonuç sayfasındakinden farklı bir fiyatla geri dönüyor; ikincisi zaman aşımına uğruyor ve kimse müşterinin koltuğu olup olmadığını söyleyemiyor; operasyondan biri de neden bir rezervasyon olup bilet olmadığını soruyor. Uçuş rezervasyon API entegrasyonu dışarıdan bir e-ticaret ödeme sayfasına benziyor. Altında ise REST'ten çok önce tasarlanmış sistemlere karşı yürütülen dağıtık bir işlem var ve sürprizlerin çoğu bu boşluktan geliyor.

Bu yazı hiç PNR görmemiş geliştirici için. Belirli bir tedarikçinin uç noktalarını anlatmıyor; isimler sağlayıcıdan sağlayıcıya değişir, şekil değişmez.

Uçuş rezervasyon API entegrasyonunda çağrı sırası

Hemen her uçuş API'si, metotlarına ne ad verirse versin, aynı dört adımı izler. Aralarındaki sınırları doğru çizmek işin büyük kısmıdır.

AdımSize ne verirNe saklamalısınızNe ters gider
AramaFiyatı ve opak bir teklif ya da ücret anahtarı olan güzergâhlarKalıcı hiçbir şey — sonuçlar hızla bayatlarFiyatı kesin sanırsınız; anahtar ödemeden önce sona erer
Fiyatlama / doğrulamaTeyitli fiyat, ücret kuralları, bagaj, bazen zorunlu yolcu alanlarıDoğrulanmış teklif ve geçerlilik süresiFiyat değişti; sınıf doldu; kurallar gösterdiğinizden farklı
RezervasyonBir rezervasyon — PNR — rezervasyon kodu ve biletleme son tarihiyleKendi referansınız, kod, son tarih, gönderilen yolcu verisinin birebir hâliCevapsız zaman aşımı; mükerrer PNR; reddedilen isimler
BiletlemeDüzenlenen e-bilet numaraları; paranın gerçekten bağlandığı yer burasıHer bilet numarası, ait olduğu yolcu ve segmentle eşleşmiş hâldeKısmi düzenleme; son tarih geçtiği için havayolunun iptal ettiği rezervasyon

İnsanların itiraz ettiği satır üçüncüsü, çünkü birçok API rezervasyon ve biletlemeyi tek çağrıda yapmanıza izin veriyor. İsterseniz kullanın. Ama havayolu dünyasında ikisi hâlâ ayrı şeyler: bilet olmadan PNR var olabilir ve PNR oluştuktan sonra biletleme başarısız olabilir. Birleşik uç nokta yalnızca birinin başarılı, diğerinin başarısız olduğu anı gizler; veri modelinizde o durum için yine de bir yer olmalı.

Aramanın döndürmediği şeye de dikkat edin: bir söz. Arama bir ilandır. Fiyatlama adımı tekliftir, satış ise yalnızca bilettir.

Aradığınız fiyat neden rezerve ettiğiniz fiyat değil

Web geliştiricileri bir katalog bekler. Havayolu envanteri katalog değildir. Bir uçuş rezervasyon sınıfları hâlinde satılır; her sınıf belli bir ücrette bir koltuk kovasıdır ve havayolu uçak doldukça bu kovaları sürekli açıp kapatır. Arama sonuçları, zaten biraz geride olabilecek müsaitlik verisinden hızla derlenir; kullanıcı iki pasaportu yazmayı bitirdiğinde o uçuştaki en ucuz kova kapanmış olabilir. Fiyatlama adımı çalıştığında yeniden sorar ve dürüst cevap bazen daha yüksektir.

Vergilerin de kendi kayması var. Fiyatlamada tam yolcular ve güzergâh için yeniden hesaplanırlar; bir çocuk ya da bebek, aramanın varsaydığı yetişkinden farklı fiyatlanır. Vitrininiz tedarikçinin fiyat verdiği para biriminden farklı bir birim gösteriyorsa — örneğin tedarikçi EUR, siteniz TRY — kur dönüşümü sayının oynadığı bir yer daha olur.

Tasarım sonucu basit ve sık atlanan bir kural: arama fiyatı üzerinden asla tahsilat yapmayın. Ödemeden önce fiyatlama adımını çalıştırın, karşılaştırın; tutar değiştiyse yeni rakamı gösterip sorun. Uyguladığınız kâr marjı da sonuç sayfasından taşınmamalı, yeniden fiyatlanan ücret üzerinden tekrar hesaplanmalı — bu, bir acentenin online kâr marjı stratejisi kurarken izlediği mantığın aynısıdır ve taban altından kaydığında aynı şekilde bozulur.

Idempotency ve rezervasyon sırasında zaman aşımının anlamı

Bu bölümü iki kez okuyun.

Bir rezervasyon çağrısı zaman aşımına uğradığında ne olduğunu bilmezsiniz. İstek hiç ulaşmamış olabilir. Ulaşıp başarısız olmuş olabilir. Ya da — can yakan durum — ulaşmış, tedarikçi havayolunda PNR'ı oluşturmuş ve cevap size dönerken kaybolmuştur. Kodunuz için üçü de aynı görünür. Havayolu içinse üçüncüsü, müşterinizin adına koltuk tutan canlı bir rezervasyondur.

Diğer entegrasyonlardan gelen refleks yeniden denemektir. Burada kör bir yeniden deneme, aynı yolcular için aynı uçuşta ikinci bir PNR üretebilir. Havayolları mükerrer rezervasyonları kural ihlali sayar; taşıyıcıya ve acentenin anlaşmalarına göre sonuç, rezervasyonlardan birinin ya da ikisinin otomatik iptalinden, düzenleyene gönderilen bir borç dekontuna — ADM — kadar uzanır. Bunu alan acente, sisteminizin neden iki kez rezervasyon yaptığını bilmek isteyecektir.

İşe yarayan, kabaca bu sırayla:

  • Dışarı çağrı yapmadan önce kendi rezervasyon referansınızı oluşturun, kaydedin ve API'nin istemci referansı kabul ettiği her yerde istekle gönderin. API idempotency anahtarını destekliyorsa kullanın; desteklemiyorsa da rezervasyonu sonradan bulmanızı sağlayan yine sizin referansınızdır.
  • Bilinmeyen durumu açıkça modelleyin. Beklemede, onaylandı, başarısız — ve bilinmiyor. Zaman aşımı rezervasyonu "başarısız"a değil, "bilinmiyor"a taşır.
  • Bilinmeyeni tekrarlayarak değil, sorarak çözün. Yeniden denemeye karar vermeden önce referansınızla sorgulayın ya da o yolcuların son rezervasyonlarını listeleyin.
  • Bir mutabakat işi çalıştırın: hâlâ bilinmeyen her şeyi tarasın, tedarikçinin bildirdiğiyle karşılaştırsın ve çözemediğini tahmin yürütmek yerine bir insan kuyruğuna yönlendirsin.

Biletleme zaman aşımları, paranın işin içine girdiği aynı sorundur. Biletlemeden önce karttan tahsilat yapar ve biletleme takılırsa, ödeme yapmış ama belki bileti olmayan bir müşteriniz olur. Tahsilattan önce biletler ve tahsilat başarısız olursa, birinin havayoluna ödemesi gereken bir belge düzenlemiş olursunuz. Yaygın kalıp önce kartta provizyon almak, sonra biletlemek, başarı hâlinde tahsil etmektir — önemli olan bunu bilinçli kararlaştırmak, canlı ortamda keşfetmemek.

Web geliştiricilerini şaşırtan seyahat kavramları

Hiçbiri zor değil. Her biri, varlığından haberi olmayan birine bir haftaya mal oldu.

PNR bilet değildir

PNR rezervasyon kaydıdır: yolcular, segmentler, iletişim bilgileri, bir son tarih. Bilet ise yolcuya uçma hakkı veren, ödemesi yapılmış belgedir. Biletlenmemiş bir PNR biletleme son tarihinde düşer ve koltuklar yeniden satışa çıkar — bazen sizin tarafınızdan hiç fark edilmeden.

İsimler neredeyse değiştirilemez

Biletlemeden sonra çoğu ücret, küçük bir düzeltme dışında isim değişikliğine izin vermez ve neyin küçük sayıldığı havayoluna göre değişir. İsim seyahat belgesiyle eşleşmelidir. Soyadı ve adı ayrı toplayın, serbest metin bir unvanın isim alanına sızmasına izin vermeyin ve doğrulamayı rezervasyon çağrısından sonra değil, önce yapın.

Yolcu tipleri süs değil, fiyattır

Yetişkin, çocuk ve bebek birer ücret tipidir ve hangisinin geçerli olduğunu belirleyen yaş genellikle rezervasyon tarihindeki değil, seyahat tarihindeki yaştır. Kucakta seyahat eden bebek çoğu zaman koltuk kullanmaz ve yalnızca bir yetişkinle seyahat edebilir. Tipi yanlış verirseniz fiyatlama ya başarısız olur ya da yanlış ücreti teklif eder.

Saatler yereldir, segment de bacak değildir

Kalkış ve varış saatleri her havalimanının yerel saatiyle verilir. Gösterirken kullanıcının saat dilimine çevirmeyin, farkları hesaba katmadan çıkarma yaparak süre hesaplamayın. Bir yolculuk segmentlerden oluşur; teknik inişli bir segment birden fazla bacak içerir. Arayüzünüz ve veriniz, "aktarma"nın bunlardan hangisi olduğu konusunda anlaşmalı.

Satıştan sonra da bir şeyler olur

Havayolları biletler düzenlendikten sonra tarifeleri değiştirir. Biletleme anında doğru olan bir rezervasyon, haftalar sonra yeni bir saat, yeni bir uçuş numarası ya da kopmuş bir bağlantıyla görünebilir; tedarikçiye göre bunu bir bildirimle, bir kuyrukla ya da rezervasyonu yeniden sorgulayarak öğrenirsiniz. Rezervasyonun, siz ona bakmayı bıraktıktan sonra da değişeceğini planlayın.

Void iade değildir

Düzenlemeden kısa süre sonra genellikle biletin hiç var olmamış gibi iptal edilebildiği (void) bir pencere vardır. O pencereden sonra yalnızca ücret kurallarına göre iade mümkündür; bu da ceza kesebilir ya da hiçbir şey geri vermeyebilir. Pencere ve kuralları tedarikçiye ve düzenleme anlaşmasına aittir; bir "iptal" düğmesi yapmadan önce okuyun.

Yanlış yapmanın bedeli

Uçuş entegrasyonundaki hatalar belirli bir şekilde pahalıdır: loglara değil, insanlara düşerler. Mükerrer bir rezervasyon, havayoluna bir telefona ve belki acentenin hesabına bir dekonta dönüşür. Ödeme yapmış ama bileti olmayan müşteri; bir iadeye, bir şikâyete ve ters ibraz riskine dönüşür. Başarılı ödeme olmadan düzenlenmiş bir bilet, birinin kapatması gereken bir havayolu borcuna dönüşür. Kimsenin işlemediği bir tarife değişikliği, daha erken kalkmış bir uçuş için havalimanında bekleyen bir yolcuya dönüşür.

Bunların hiçbiri mutlu yol testinde görünmez. Önce mutsuz yolları yazın: rezervasyon sırasında zaman aşımı, yükselen fiyat, PNR'dan sonra başarısız olan bilet, başarılı ödemeden sonra yapılan void. Bunlar ele alındıysa mutlu yol kolay kısımdır.

Bir uçuş API'sine karşı test

Tedarikçi test ortamları faydalıdır ama eksiktir. Genellikle canlı ortamdan daha sakindirler; dolan sınıflar ve fiyat değişiklikleri daha seyrektir, bazıları zaman aşımını hiç simüle etmez. Onları çağrıların şekli ve doğrulama hataları için kullanın; ardından canlıda, pencere içinde void ettiğiniz gerçek rezervasyonlarla kontrollü bir deneme planlayın — operasyon ekibinin haberi olarak.

Entegre edip etmemek ayrı bir soru. Gerçekten ihtiyacınız olan şey kendi sisteminizde ham envanter değil de bir vitrinse, ödünleşim white label mi, kendi rezervasyon motorunuz mu yazısında anlatılıyor; aynı mantık alt acenteler için B2B portal için de geçerli. Envanteri kendi kodunuzda istiyorsanız, bu platform uçuş ve otel API'leri sunuyor; erişim self-servis bir anahtarla değil, kullanım senaryonuz üzerine bir görüşmeyle başlıyor — yukarıdaki soruların her birini sormak için de doğru an orası.

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.