API entegrasyonu, iki sistem arasında tanımlı bir iş akışıdır
Bir API entegrasyonu, bir sistemde başlayan işlemin başka bir sistemde hangi kurallarla sürdürüleceğini tanımlar. Sadece iki yazılımın birbirine bağlanması yeterli değildir: Hangi kaydın oluşturulacağı, kimlerin erişeceği ve işlem yarıda kalırsa ne yapılacağı da belirlenmelidir. Restoran rezervasyonunda bu ayrım özellikle önemlidir; müsaitlik görmek, masayı geçici olarak tutmak ve kesinleşmiş rezervasyon oluşturmak farklı adımlardır.
Örneğin bir üyelik uygulaması kendi kullanıcılarına restoran rezervasyonu sunmak istiyor. İlk görüşmede uygulamanın hangi restoranları gösterebileceği, misafirden hangi bilgileri alacağı ve rezervasyon sonucunu nasıl bildireceği belirlenir. Bu kararlar verilmeden bir API anahtarı edinmek, çalışır bir misafir deneyimi oluşturmaz.
Önce partner türü, erişim ve veri sınırı belirlenir
Üyelik, banka, otel ve concierge gibi dış rezervasyon kanalları Guest Network modeliyle ele alınabilir. Bu ortakların amacı, izinli restoranlar için müsaitlik sorgulamak ve rezervasyon akışını kendi uygulamalarına eklemektir. POS sağlayıcısının ihtiyacı farklıdır: Var olan rezervasyon ile check-in veya servis kaydını ilişkilendirmek. Aynı API altyapısında bulunsalar da iki partner türüne aynı işlemler açılmaz.
Entegrasyon kapsamına erişilebilir restoranlar, işlem izinleri, misafir iletişim alanları ve test sorumluları yazılır. Misafir iletişim bilgileri için ayrıca erişim izni gerekebilir; teknik erişim, verinin pazarlama amacıyla kullanılabileceği anlamına gelmez.
Rezervasyon, tek bir onay düğmesinden ibaret değildir
Guest Network senaryosunda uygulama önce partnerin erişimindeki restoranları listeler, mekanın rezervasyon koşullarını öğrenir ve tarih-saat müsaitliğini sorgular. Kullanıcı seçim yaptığında geçici hold oluşturulur. Ardından confirm yanıtı değerlendirilir. Ödeme gerekmeyen rezervasyon bu adımda oluşabilir; anında ön ödeme veya provizyon isteyen bir senaryoda ödeme ve Finalize adımları gerekebilir.
Örneğin misafir 3D Secure ödemesini tamamlayıp uygulamaya dönmezse tahsilat başarılı olsa bile Finalize yapılmamış olabilir. Entegrasyon ekibi bu durumu izleyecek sorguları ve tekrar deneme davranışını geliştirmelidir. Kullanıcıya yalnızca kesinleşmiş kayıt doğrulandığında onay gösterilir.
Webhook bildirir; güncel rezervasyon API'den okunur
Rezervasyon oluşturma, değişiklik veya iptal gibi desteklenen olaylarda Rezervem partner sistemine webhook gönderebilir. Bildirim güncel rezervasyonun bütün alanlarını taşımaz. Alıcı sistem imzayı doğrular, aynı olayın tekrar gelmesine hazırlıklı olur ve güncel rezervasyon durumunu yetkili API çağrısıyla alır.
Örneğin aynı rezervasyon için onay ve ardından iptal gerçekleştiyse webhook'lar farklı sırayla ulaşabilir. Ekip, en son ulaşan olay adını kesin durum gibi göstermek yerine güncel rezervasyon kaydını kontrol eder. Böylece iki uygulama misafire çelişen bilgi sunmaz.
Canlıya geçişi başarı ve hata senaryolarıyla tamamlayın
Test ortamında başarılı rezervasyon dışında dolu saat, hold süresi dolması, ödeme dönüşünün kesilmesi, izin verilmeyen restoran ve tekrarlanan webhook senaryolarını deneyin. Rezervasyon oluşturma yetkisinin gerekli onaylarla açıldığını doğrulayın. POS ortağıysanız ayrıca doğru rezervasyon ile servis kaydının eşleştiğini kontrol edin.
Rezervem'de kurumsal iş ortaklığı ve restoran kapsamı Guest Network ile, teknik işlemler Partner API ile ele alınır. Geliştirme ekibi müsaitlikten kesinleşmeye rezervasyon akışını inceleyebilir. Kullanım senaryosuna göre entegrasyon görüşmesi için iletişime geçebilirsiniz.
