Seyahat API sandbox testi: sandbox'ın size göstermedikleri

Entegrasyon, seyahat API sandbox testi sırasında karşısına çıkan her şeyi geçti. Arama uçuş döndürdü, otel müsaitlik çağrısı oda getirdi, rezervasyon çağrısı her seferinde bir onay numarası verdi ve QA ekibi perşembe günü onayı bastı. Ertesi salı bir müşteri oteli bir fiyattan ödedi, tedarikçi başka bir fiyattan onayladı; bir uçuş rezervasyonu zaman aşımına uğradı ve kimse koltuğun tutulup tutulmadığını söyleyemedi; bir destek çalışanı bütün öğleden sonrasını aynı seyahati anlatan iki kaydı eşleştirmekle geçirdi. Bunların hiçbiri test paketinin kaçırdığı bir hata değildi. Test paketinin görmesinin hiçbir yolu olmayan senaryolardı. Sandbox gereklidir ama yeterli olmaktan çok uzaktır; bir seyahat entegrasyonundaki pahalı olayların çoğu tam da bu aradaki boşlukta yaşanır.
Bu yazı, o entegrasyonun sahibi olan geliştirici için bir test planı: sandbox neyi kanıtlayabilir, yapısı gereği neyi kanıtlayamaz ve aradaki farkı şirket kartıyla gerçek koltuk ayırmadan nasıl kapatırsınız.
Seyahat API sandbox testi neden canlıda kırılan kodu geçirir
Sandbox, yanıtların biçimine dair bir sözdür, davranışına dair değil. Şema canlı ortamla aynıdır. Davranış ise neredeyse hiç aynı değildir ve bunun suçlusu yoktur: bir test ortamı canlı envanter çalıştırmayı göze alamaz, bu yüzden hiç tükenmeyen, fiyatı hiç değişmeyen, tarifesi hiç oynamayan sabit bir ücret ve oda seti sunar. Başka kimse kullanmadığı için hızlı yanıt verir. Yarıda kalarak başarısız olması nadirdir.
Canlı ortam bunların hepsini her gün yapar. Envanter diğer tüm satıcılarla paylaşılır; ücretler zincirin bir yerinde önbelleğe alınır ve bayatlar; yük altındaki bir tedarikçi sistemi yavaş yanıt verir ya da hiç vermez. Yalnızca sandbox görmüş bir kod, pratikte yalnızca kusursuz bir gün geçiren tedarikçiye karşı test edilmiştir.
O yüzden sandbox'ı üç katmandan biri olarak görün. İsteklerinizin doğru kurulduğunu ve ayrıştırıcınızın şemayı anladığını kanıtlar. Kaydedilmiş fixture'lar, kodunuzun canlı ortamın gerçekten gönderdiği yanıtlara dayandığını kanıtlar. Küçük ve bilinçli bir canlı kontrol seti de bir şey değiştikten sonra kablolamanın sağlam olduğunu kanıtlar. Her katman diğer ikisinin yakalayamadığını yakalar.
Sandbox'ın genellikle size veremediği senaryolar
Tek bir test yazmadan önce bunları kâğıda dökün. Sandbox bir ya da ikisini sihirli bir test değeriyle taklit edebilir; çoğu ise orada hiç yoktur.
| Senaryo | Canlı ortam ne yapar | Nasıl kapsanır |
|---|---|---|
| Arama ile rezervasyon arasında fiyat değişir | Rezervasyon farklı bir toplamla başarılı olur ya da göstermeniz gereken bir fiyat değişikliği hatasıyla düşer | Fixture çifti: bir arama yanıtı ve farklı toplamlı bir rezervasyon yanıtı; yolcuya yeniden sorulduğunu, sessizce tahsilat yapılmadığını doğrulayın |
| Müsaitlik ile rezervasyon arasında tükenme | Sunulan oda ya da ücret sınıfı tutmaya çalıştığınızda yoktur | Tedarikçinin gerçek "tükendi" hatasının fixture'ı; yolcunun hata sayfasına değil sonuçlara döndüğünü doğrulayın |
| Rezervasyon çağrısında zaman aşımı | Tedarikçi rezervasyonu oluşturmuş da olabilir, oluşturmamış da | İstek gönderildikten sonra zaman aşımı enjekte edin; herhangi bir yeniden denemeden önce rezervasyon durumunun sorgulandığını doğrulayın |
| Mükerrer gönderim | Çift tıklama ya da istemci tarafı yeniden deneme iki rezervasyon yaratır | Aynı rezervasyonu aynı idempotency anahtarıyla iki kez gönderin; tam olarak bir rezervasyon olduğunu doğrulayın |
| Biletleme sonrası tarife değişikliği | Sattığınız uçuş artık başka saatte ya da başka uçuş numarasıyla kalkıyor | Değiştirilmiş güzergâh fixture'ı; değişikliğin müşteriyle ilişkiyi yöneten kişiye ulaştığını doğrulayın |
| Çok kalemli rezervasyonda kısmi başarı | Uçuş onaylanır, otel onaylanmaz | Karışık fixture; sistemin tam olarak neyin onaylandığını kaydettiğini ve bir insanı uyardığını doğrulayın |
| Yük altında kısıtlama | Rate limit yanıtları, ardından yavaş cevaplar | Kaydedilmiş bir kısıtlama yanıtını tekrar oynatın; geri çekilmeyi ve aramanın hata vermek yerine yavaşladığını doğrulayın |
Son sütuna kendi altyapınız için itiraz edebilirsiniz. Olabilir. Önemli olan her satırın bir sahibi ve bir doğrulaması olması; çünkü her biri eninde sonunda başınıza gelecek.
Fixture'ları uydurma değil gerçek yanıtlardan kurun
Bir seyahat entegrasyonundaki en yararlı alışkanlık, sizi şaşırtan yanıtları saklamaktır. Elle yazılmış sahte veri, tedarikçinin ne gönderdiğini sandığınızı yansıtır; kaydedilmiş bir yanıt ise gerçekte ne gönderdiğini: dokümantasyonun asla boş olmaz dediği boş alanları, istemediğiniz bir para birimindeki fiyatı, başarı durum koduyla gelen hatayı.
İşleyen bir rutin:
- Sınırda kaydedin. Tedarikçi çağrılarının ham istek ve yanıt gövdelerini canlı olmayan ortamda, gizlilik kurallarınız izin veriyorsa canlıda da trafiğin örneklenmiş bir kısmı için loglayın.
- Saklamadan önce temizleyin. Yolcu adları, pasaport numaraları, e-postalar, telefonlar ve ödeme referansları fixture depoya girmeden çıkarılır. Kimse onu gerçek rezervasyon sanmasın diye açıkça sahte değerlerle değiştirin.
- Fixture'lara davranışa göre ad verin.
hotel-book-price-increased.jsonbir sonraki geliştiriciye neden var olduğunu söyler;response-17.jsonsöylemez. - Çirkin olanları sonsuza kadar tutun. Bir pazar günü aramayı çökerten bozuk yanıt, sahip olduğunuz en değerli dosyadır. Her commit'te çalışan bir testte yer almalıdır.
Ardından bu fixture'lara karşı sözleşme testleri yazın: ayrıştırıcınız, iç modellere eşlemeniz ve hata sınıflandırmanız. Tedarikçi bir alanın adını değiştirir ve sözleşme testi kırılırsa, bunu bir müşteriden değil CI'dan öğrenirsiniz. Sınıflandırma tarafını rezervasyon motoru API hata yönetimi yazımızda daha ayrıntılı ele aldık.
Para yollarını para harcamadan test etmek
Sandbox'ın en az işe yaradığı yer burasıdır, çünkü para yolları tam olarak test ortamının gerçeğinden ayrıştığı yerdir. Gerçek biletleme, gerçek kart tahsilatı ve gerçek tedarikçi faturası, doğru olması en çok gereken ve canlı provası en az yapılabilen şeylerdir.
Sorunu bölün. Fiyatlama matematiği saf mantıktır ve çevrimdışı olarak eksiksiz test edilebilir: kaydedilmiş ücretleri alın, markup kurallarınızı, kur dönüşümünü ve yuvarlamayı uygulayın, yolcunun gördüğü toplamı doğrulayın. Bunu zor vakalar için yapın: EUR ile gelen bir ücretin TL ile satılması, bir üründe yüzde, diğerinde sabit tutar olan bir markup, çocuk ücreti, gösterim ile tahsilat arasında farklı çalışan bir yuvarlama adımı. Birkaç kuruş yanlış bir toplam yine yanlıştır ve her rezervasyonda yanlıştır.
İkinci yarı, ödeme etrafındaki durum geçişleridir. Bunları açıkça modelleyin: teklif edildi, opsiyonlandı, ödendi, onaylandı, biletlendi, iptal edildi, iade edildi. Ve her geçişin tam olarak bir nedeni olduğunu test edin. En pahalı hatayı yakalayan test, tedarikçinin onaylamadığı bir rezervasyon için ödeme tahsil edilemeyeceğini ve ödeme kaydı olmadan onaylı rezervasyon var olamayacağını doğrulayan testtir.
Son olarak, bir test koşusunun canlı biletlemeye ulaşmasını imkânsız kılın. Düşük ihtimalli değil; imkânsız. Canlı kimlik bilgileri yüklüyse test paketini çalıştırmayı reddeden bir başlangıç kontrolü tek satırdır ve bir entegrasyon ekibinin yaşayabileceği en kötü sabahı önler.
Yanlış yaparsanız size maliyeti
Bir seyahat entegrasyonunda kaçırılmış bir senaryo nadiren hata olarak görünür. Sorunsuz görünen bir rezervasyon olarak görünür. Kimsenin istemediği, birinin süre dolmadan void etmesi gereken mükerrer bir bilet. Acentenin artık üstlenmek zorunda kaldığı bir fiyattan onaylanmış otel. Sistemin yeniden denediği, zaman aşımına uğramış bir rezervasyon; tedarikçi iki oda tutar ve ikisini de faturalar. Acente üzerinden satılan bir uçak biletinde, kesilen ile satılan arasındaki uyumsuzluk sonradan ADM olarak geri dönebilir; o satıştaki marj çoktan harcanmışken.
Bu maliyetler seyahati satan işletmenin üstüne düşer, yeniden deneme döngüsünü yazan geliştiricinin değil. Bunları lansmandan önce test etmenin, her seferinde bir destek kaydıyla öğrenmek yerine, bütün gerekçesi budur.
Her tedarikçi değişikliğinden sonra hızlı kontrol
Tedarikçiler bir şeyleri değiştirir: yeni bir API sürümü, yeni bir uç nokta, yenilenmiş bir kimlik bilgisi, farklı bir içerik eşlemesi. Kendi kodunuz hiç değişmemiş olabilir. Bu listeyi yine de, değişen tedarikçiyle konuşan ortamda çalıştırın:
- O tedarikçiden sattığınız her ürün için, sonuç döndüğünü bildiğiniz bir hat ya da şehirde (örneğin İstanbul–Dubai) bir arama.
- Hiçbirini sessizce düşürmeden tüm sonuçları ayrıştırın; sayınızı ham yanıttakiyle karşılaştırın.
- Bir sonucu baştan sona fiyatlayın ve gösterilen toplamı ham ücretten kendi hesabınızla karşılaştırın.
- Test ortamında bir rezervasyon yapın, durumunu geri okuyun ve sakladığınız her alanı karşılaştırın.
- İptal edin ve iptalin hem kendi kayıtlarınızda hem tedarikçi tarafında göründüğünü doğrulayın.
- Kaydettiğiniz çirkin fixture'ları yeni ayrıştırıcıdan tekrar geçirin.
- Zaman aşımlarının ve rate limit'lerin hâlâ kararlaştırdığınız davranışa eşlendiğini kontrol edin; yeni sürüm bunlara farklı yanıt verebilir. Yanıt süreleri değiştiyse, gecikme yazımız bunun hangi kısmının sizin elinizde olduğunu anlatıyor.
Her seferinde çalıştırılacak kadar kısa; mesele de bu. Bir gün sürdüğü için kimsenin çalıştırmadığı hızlı kontrol, hızlı kontrol değildir.
Sandbox'ın yeri
Bunların hiçbiri sandbox'ı daha az yararlı kılmaz. Onu dürüst kılar: şemayı öğrendiğiniz ve isteklerin doğru olduğunu teyit ettiğiniz yer; ulaşamadığı kısımları fixture'lar ve canlı kontroller devralmadan önce. Platformun uçuş ve otel API'lerini değerlendiriyorsanız, erişim self-servis bir anahtarla değil bir görüşmeyle başlar; bu test planını o görüşmeye getirin ve yukarıdaki tablonun her satırının nasıl kapsanacağını sorun. Cevaplar size bir API hakkında dokümantasyonundan daha fazlasını anlatır.