Dubai'de API entegrasyon şirketi tutmadan önce

Masada üç teklif var. Her entegrasyon şirketinin seyahat sitelerinden oluşan bir portföyü var, hepsi "uçuş API'sini sitenize bağlamayı" vaat ediyor ve en ucuzu gelecek hafta başlayabiliyor. Deira'da altı çalışanlı, kurumsal müşterisi düzenli bir acente işletiyorsunuz ve tedarikçinin extranet'inden fiyatları WhatsApp mesajlarına elle aktarmaktan yoruldunuz. Dubai'de en yetkin görünen API entegrasyon şirketini seçmek, kararın tamamıymış gibi geliyor.
Aslında kararın üçte biri kadar. Sitenin satıp satmayacağını belirleyen kararlar üç teklifin hiçbirinde yok, çünkü bunlar kod değil. Tedarikçinin kiminle sözleşme yaptığı, biletlerin kimin adına kesildiği, rezervasyonla biletleme arasında paranın nerede durduğu ve müşteri iptal ettiğinde iadeyi kimin yaptığı. Bir entegratör bunların hepsini birbirine bağlayabilir. Hiçbirinin yerine geçemez.
Bu yazı iş tanımını imzalayacak acente sahibi için yazıldı, onu okuyacak yazılımcı için değil.
Dubai'de bir API entegrasyon şirketi neyi teslim edebilir, neyi edemez
Entegrasyon şirketi, tedarikçinin API'si ile siteniz arasındaki kodu yazar: arama formu, müsaitlik sorgusu, ödeme öncesi fiyat kontrolü, rezervasyon isteği, sonucu gösteren ekranlar ve iş tanımında yazıyorsa iptal ve iade çağrıları. İyileri sıkıcı ama önemli kısımları da üstlenir: tedarikçi geç yanıt verdiğinde yeniden deneme, başarısız bir rezervasyonun izini sürmeyi sağlayan kayıtlar, canlı ortam gibi davranan bir test ortamı.
Size veremeyeceği şey, o kodun öbür tarafındaki her şeydir. Tek satır yazılmadan önce acentenin şunlara ihtiyacı var:
- acentenin kendi adına açılmış ve API erişimi tanımlanmış bir tedarikçi hesabı;
- kendi akreditasyonu ya da adına bilet kesen bir consolidator üzerinden biletleme yetkisi;
- o tedarikçiyle bir para düzeni: depozito, kredi limiti ya da doğrudan geçen kart ödemeleri;
- bilet sonrası işleri (void, iade, yeniden düzenleme, tarife değişiklikleri) API üzerinden, olmuyorsa elle yapacak biri.
"Tedarikçi tarafını biz hallederiz" diyen bir entegratör çoğu zaman size kendi hesabını ödünç vermeyi teklif ediyordur. Bir prototip için makul bir kestirme olabilir. Bir işletme içinse rezervasyon sitenizin elinizde olmayan ve yanınızda götüremeyeceğiniz bir ilişki üzerinde çalışması demektir.
İş tanımı: sözleşmeye girecek yedi madde
Entegratörle yaşanan anlaşmazlıkların çoğu, kimsenin yazmadığı bir cümleye dayanır. Bunları imzaladığınız belgeye açık bir dille koyun ve her birinin cevabını yazılı isteyin.
- Tedarikçi hesabı ve API anahtarları kimin adına. Acentenin. Anahtarlar kimlik bilgisidir: sizin parola kasanızda durur, entegratöre sahiplik değil erişim verilir.
- Siteyi kim barındırıyor, alan adı kimde. Alan adı acente adına kayıtlıdır. Barındırma hesabı acentenindir ya da sözleşme nasıl devredileceğini açıkça yazar.
- Hangi işlemler kapsamda. Tek tek sayın: arama, fiyatlama, rezervasyon, biletleme, iptal, iade, değişiklik. Listede olmayan her şey, sitenin ömrü boyunca tedarikçi masasına giden bir e-posta olarak kalır. En sık unutulanlar iade ve değişikliktir, çünkü hiçbir demo onları göstermez.
- Tedarikçi API'sini değiştirdiğinde bakımı kim yapacak. Tedarikçiler sürümleri emekliye ayırır, alanların adını değiştirir. Bakım maddesi olmayan sabit fiyatlı bir iş, ilk sürüm değiştiği gün biter.
- Teslim ne demek. Acentenin sahibi olduğu bir depoda kaynak kod, tüm kimlik bilgileri ve başka bir yazılımcının işi devralmasını sağlayacak bir doküman. "Size bir zip göndeririz" teslim değildir.
- Canlıya geçiş nasıl kanıtlanır. Tedarikçinin test ortamında aramadan biletlemeye uzanan, iptali de içeren bir test rezervasyonu; gerçek bir müşterinin kartından tek kuruş çekilmeden önce.
- Müşteri verisine ne olur. Yolcu adları, pasaport bilgileri, ödeme referansları: nerede saklandıkları, kimin görebildiği, nasıl silindikleri.
Bunların hiçbirini yazmak için teknik bilgi gerekmez. Hepsi, inşadan önce anlaşıldığında sonradan pazarlık edilmesinden daha ucuzdur.
Tedarikçi içeriğini sitenize getirmenin üç yolu
Bir tedarikçinin API'sine karşı entegratör tutmak yollardan yalnızca biri. Seçimi bir teklif sizin yerinize yapmadan önce diğer ikisinin yanında görmeye değer.
| Yol | Tedarikçi ilişkisi kimde | Bağlantıyı kim çalışır tutar | Acentenin hâlâ kurması gerekenler | Ayrılmanın maliyeti |
|---|---|---|---|---|
| Entegratör sitenizi bir tedarikçinin API'sine bağlar | İş tanımı öyle diyorsa acentede; yoksa çoğu zaman entegratörde | Bakım sözleşmesiyle entegratör ya da hiç kimse | Yönetim paneli, kâr marjları, müşteri kayıtları, raporlar, ödemeler, satış sonrası ekranlar | Kod ve anahtarlar sizinse az; değilse yeniden inşa |
| Entegratör sitenizi bir platformun API'sine bağlar | Tedarikçi sözleşmeleri platformda; acentenin platformda kendi hesabı var | Tedarikçi tarafı platform, sizin tarafınız entegratör | Siteniz ve platform API'sinin kapsamadığı her şey | Kendi tarafınızı başka bir API'ye göre yeniden yazmak |
| Zaten bağlı bir white-label vitrin | Acentenin hesabı üzerinden platform | Platform | İçerik, fiyat kararları, kendi müşterileriniz | Alan adını ve müşteri listesini başka bir sağlayıcıya taşımak |
Tartışmaya değer olan ilk satır. En fazla kontrolü verir ve en fazla yükü size bırakır: her tedarikçi değişikliği, her yeni hizmet ve ilk inşanın atladığı her işlem, yeni teklifli yeni bir projeye dönüşür.
Zaten işlettiğiniz bir siteye arama eklemek mevcut web sitesine uçuş arama ekleme yazısında, arkasında kimin API'sinin duracağını seçmek ise uçuş rezervasyon API sağlayıcısı seçimi yazısında tartışılıyor. Bu yazı işin etrafındaki sözleşmeyle ilgili.
Bu platform nerede duruyor
Bu blogun arkasındaki platform uçuş ve otel API'leri sunar. Erişim kendi kendine alınan bir anahtarla değil bir görüşmeyle başlar, çünkü ilk sorular yukarıdakilerdir (hangi hizmetler, hangi pazar, para nasıl akıyor), hangi uç noktanın çağrılacağı değil. Hizmetler her hesap için ayrı açılır ve her hesabın kendi rezervasyonları, müşterileri, kâr marjları ve raporlarıyla kendi yönetim paneli vardır; bu yüzden ikinci satırdaki "hâlâ kurması gerekenler" sütunu göründüğünden kısadır.
Sizin tarafınızı bir entegrasyon şirketi kuracaksa, bir teklifi kabul etmeden önce bu görüşmeyi yapın ki iş tanımı gerçekten bağlanacağı API'yi anlatsın. Seyahat API'leri sayfası başlangıç noktası.
Zayıf bir iş tanımının size maliyeti
Site yayına girer. Arama çalışıyor, fiyatlar doğru görünüyor ve ilk rezervasyon bir perşembe akşamı geliyor. Acentenizin adına biletlenemiyor, çünkü tedarikçi hesabı entegratöre ait ve onun düzeni altında bilet kesiyor. Müşterinin kartından para çoktan çekildi. Elinizde, kendi sitenizden ne biletleyebildiğiniz ne de iade edebildiğiniz bir rezervasyon var.
Ya da bir yıl boyunca çalışır. Sonra tedarikçi yeni bir API sürümüne geçer, rezervasyon durur ve sabit fiyatlı sözleşmesi teslimde biten entegratör yeni bir proje için teklif verir. Ödersiniz, çünkü kodu anlayan tek kişiler teklifi verenlerdir.
Ya da entegratör basitçe başka bir müşteriyle meşguldür. Bir yolcunun biletteki adının düzeltilmesi gerekir, değişiklik işlemi hiç kapsamda değildi ve iki çalışanınız öğleden sonrayı tedarikçi masasına e-posta yazarak geçirir. Sitenin ortadan kaldırması gereken iş tam olarak buydu.
Bunların her biri iş tanımında eksik kalmış tek bir cümle. Kod her seferinde sorunsuzdu.