Otel ve uçuş rezervasyon API'si: tek seyahat, iki rezervasyon

Bilette şöyle yazıyor: "uçuş akışına otel ekleyin, tek ödeme, tek toplam." Bir ürün yöneticisinden gelen makul bir istek ve bir günlük iş gibi duruyor, çünkü uçuş aramanız ve ödeme sayfanız zaten var. Üç hafta sonra ekip, havayolu onayladığında ama otel onaylamadığında ne olacağını tartışıyor. Otel ve uçuş rezervasyon API'si, iki tür sonuç döndüren tek bir entegrasyon değildir. Aynı sepeti paylaşan iki entegrasyondur.
Kod bunu ne kadar erken kabul ederse, o kadar az kısmı yeniden yazılır. Aşağıda entegrasyon kılavuzlarının atladığı kısım var: iki yarının nasıl ayrıştığı, hangisinin önce onaylanacağı ve bir seyahatin veri modelinizde ne olması gerektiği.
İki yarı aynı davranmaz
İkisi de fiyat ve referansla JSON olarak döner, yani kabloda birbirine benzer. Referansı aldıktan sonra size verdikleri söz ise aynı değil.
| Soru | Uçuş | Otel |
|---|---|---|
| Rezervasyondan sonra elinizde ne var | Henüz bilet olmayan bir rezervasyon (PNR) | Çoğunlukla zaten sattığınız şeyin kendisi olan bir onay |
| Fiyat ne kadar geçerli | Ücretin rezervasyon anında yeniden fiyatlanmasına kadar; bu, aramadakinden farklı olabilir | Oran süresi dolana kadar; oran, müsaitlik ile rezervasyon arasında değişebilir |
| Onayı ne verir | Biletleme, çoğu zaman bir süre sınırına karşı | Tedarikçinin onayı; bazen anında, bazen beklemede |
| Nasıl geri alınır | Erken yakalanırsa void, aksi halde ücret kurallarına göre iade, çoğu zaman cezalı | Oranın kendi politikasına göre iptal; birçok oranda belli bir saate kadar ücretsiz |
| Rakamı geç değiştiren nedir | Ücret, vergiler, bazen ücretin para birimi | Tesiste ödenen vergi ve ücretler, pansiyon tipi, gerçekte verilen oda |
Bir satıra itiraz edebilirsiniz, çünkü tedarikçiler farklıdır; ama biçimine itiraz edemezsiniz: bir yarıda biletleme adımı, diğerinde iptal penceresi var ve ikisi zamanda hizalanmıyor. Sıranın uçuş tarafını uçuş rezervasyon API entegrasyonu yazımızda, otel tarafındaki yavaş tedarikçi sorununu ise otel müsaitlik API istemci tasarımı yazımızda ele aldık. Bu yazı onların bittiği yerde, birleşim noktasında başlıyor.
Hangisini önce rezerve edersiniz?
Bunun bir tasarım kararı olduğunu kimse söylemez; oysa bir hatanın size neye mal olacağını bu karar belirler.
Bir müşteri aynı tarihler için uçuş ve otel satın alıyor. Önce birini, sonra diğerini gönderirsiniz. Üç şey olabilir: ikisi de çalışır, biri başarısız olur ya da biri, diğeri başarılı olduktan sonra başarısız olur. Birincisi güzel bir gündür. Diğer ikisi destek kuyruğunuzu belirler.
Önce uçuşu biletler, sonra otel reddederse, bir şehre koltuğu olan ama odası olmayan, parası çekilmiş bir müşteriniz ve cezalı bir biletin iadesi kalır. Önce oteli rezerve eder, sonra uçuş başarısız olursa, çoğu zaman ücretsiz iptal edebileceğiniz bir oda elinizde kalır; onarım ucuzdur. Ters risk de gerçektir: iptal edilemeyen bir otel oranı elde tutulacak en kötü şeydir, bu yüzden önce gitmesine izin vermeden oranın iptal koşullarını okuyun.
Bu bir kuraldır, yasa değil; asıl mesele sırayı bilerek seçmenizdir. Geri alması kolay olan yarıyı zor olandan önce onaylayın, ikisi de onaylanmadan hemen önce her iki fiyatı da kontrol edin ve üç sonucun her biri için ne yaptığınızı yazın. İncelemeciler nadiren sorar. Müşteriler her zaman öğrenir.
Tek seyahat, iki rezervasyon
Dayanıklı olan biçim, her biri kendi referansına, durumuna ve koşullarına sahip iki rezervasyonu barındıran bir seyahat kaydıdır. Müşteri tek toplam görür. Veritabanınız iki satır görür; toplam sizin hesapladığınız bir toplamdır, tedarikçide var olan bir şey değil.
İki durumu ayrı tutun. Otel için "onaylandı" ile uçuş için "biletlendi" aynı durum değildir ve ikisini düzleştiren tek bir durum sütunu er ya da geç yarım rezerve edilmiş bir seyahatin üstüne "rezerve edildi" yazar.
Değişiklik koşullarını da ayrı tutun ve gösterin. Görünen bir toplam, tarihleri kaydırmanın bir yarıda ücretsiz, diğerinde ücretli olduğunu gizler. Ön yüzünüz "tarihleri değiştir"i tek düğme olarak gösteriyorsa, yalnızca bir yarı taşınabildiğinde ne yapacağına, bunu bir müşteri sizin yerinize keşfetmeden önce karar verin. Aynısı kâr payı için de geçerli: çoğu satıcı gibi hizmet başına ekliyorsanız, seyahat toplamı iki kâr payıdır ve bir yarıdaki iadenin hangi payı geri verdiğini bilmesi gerekir. Birleşik bir seyahat parada pahalılaşır, çünkü kalemler farklı takvimlerde kapanır ve uçuş iadesi, otel iptalinin geldiği anda gelmez.
Bu platform nerede duruyor
Açıkça: platform uçuş ve otel API'leri sunar ve erişim, self servis bir anahtarla değil, bir görüşmeyle başlar. Hizmetler kiracı bazında açılır; otel satıp tur satmayan bir kiracı tur yüzeyini taşımaz. Burada iki yarıyı atomik olarak rezerve eden tek bir çağrı vaadi yoktur ve öyleymiş gibi tasarım yapmamalısınız. İkisini, sahibi olduğunuz bir seyahatin altındaki iki rezervasyon olarak ele alın.
Etrafında bir şey kurmadan önce gerçek çağrıları ve koşulları görmek istiyorsanız, seyahat API'leri sayfasından başlayın ve rezerve etmeyi düşündüğünüz sırayı yanınızda getirin. Ücretsiz erişimin size ne verdiğine hâlâ karar veriyorsanız, ücretsiz otel rezervasyon API'si yazısı ücretsizin türlerini anlatıyor.
Yanlış yapmanın bedeli
Pahalı sürüm sessiz olandır. Müşteriye bir şehre bilet kesilir, oda gitmiştir ve ilk haberiniz gece, bir havalimanından gelen bir mesajdır. Daha ucuz ama yine de gerçek olanlar: tek bir güven verici toplam gösterip fiyat kontrolünden sonra müşterinin kabul etmediği ikinci bir rakam çıkaran ödeme; uçuşu iade edip oteli unutan iade; tedarikçi aksini söylerken "rezerve edildi" diyen durum.
Bunların hiçbiri akıllı bir çözüm gerektirmez. Seyahatin gerçek bir nesne olmasını, sıranın birinin yazıp kaydettiği bir karar olmasını ve ikisinden biri onaylanmadan hemen önce her iki fiyatın yeniden kontrol edilmesini gerektirir. Bunu bir kez kurun; ödeme adımı bilet isteyenin istediği kadar basit görünebilir.