İlk adım kod değil, kullanım senaryosu
Kendi uygulamasında restoran listelemek ve rezervasyon oluşturmak isteyen bir Guest Network ortağının ilk işi kod yazmak değildir. Önce ihtiyaç duyduğu restoranları, rezervasyon adımlarını ve erişim izinlerini netleştirmelidir. POS partneriyse yeni rezervasyon oluşturmaya değil mevcut rezervasyonu servis operasyonuna bağlamaya odaklanır. Önce iki sistemin nerede buluşacağını tanımlarsınız: Partner API, Guest Network rezervasyon akışı ile POS servis entegrasyonuna farklı yetkiler sağlayan teknik katmandır.
Guest Network senaryosunda bu bağlantı üzerinden tamamlanan rezervasyon, Rezervem'deki ilgili rezervasyon ve misafir kaydında görünür. POS senaryosunda ise amaç var olan rezervasyonu doğru servis işlemiyle eşleştirmektir. Kullanım senaryosunu tek paragrafta anlatın; teknik görüşme, belirsiz özellik listesinden değil somut bir işlemden başlasın.
Kapsamı ilk görüşmede birlikte çizin
İlk görüşmede partnerin POS mu Guest Network mü olduğunu belirleyin. Guest Network için müsaitlik, hold, confirm, ödeme/finalize ve webhook ihtiyacını; POS için mevcut rezervasyon okuma, check-in veya servis kaydı eşleştirmesini netleştirin. Hangi restoranların veya markaların kapsama gireceği de aynı çerçevede belirlenir. Bu kararlar, entegrasyonun teknik tasarımını doğrudan şekillendirir.
Misafir verisinin hangi amaçla işleneceğini ve erişim izinlerini ayrıca belirleyin. Kullanıcı iletişim bilgilerine erişim, rezervasyon bilgilerini okumakla aynı izin değildir; pazarlama için ayrıca uygun hukuki koşullar gerekir. Kapsamı genişletme taleplerini ve canlıya geçiş kararını görüşme notuna ekleyin.
Test ortamında temel akışı kurun
Kapsam netleşince test ortamında entegrasyonu kurun. Partner API, OAuth2 Client Credentials ile kimlik doğrulaması kullanır; uygulama sırrını tarayıcıya veya mobil uygulamanın koduna yerleştirmeyin. Teknik API referansı bulunmakla birlikte gerçek istekler için tanımlanmış partner yetkileri ve uygun erişim gereklidir. Test kimlik bilgilerini güvenli biçimde saklayın.
Geliştirmeye müsaitlik sorgusuyla başlamak, akışın ilk parçasını hızlıca görünür kılar. Guest Network senaryosunda sonra hold ve confirm akışını, gerekiyorsa ödeme/finalize ayrımını, ardından olay bildiren webhook’u kurarsınız. POS partneri kendi operasyon izinlerine uygun farklı bir test akışı izler. Test rezervasyonu Rezervem’de doğru restoranda ve doğru saatte göründüğünde, iki sistem arasındaki temel bağlantı çalışır hâle gelir. Bu kontrolde yanıtın içeriğini, rezervasyon kaydını ve sonraki bildirimi birlikte izlemek gerekir.
REST API ve webhook akışı tamamlar
REST API, sisteminizin Rezervem’e talep göndermesini, müsaitlik sormasını ve kapsam içindeki rezervasyon işlemlerini yürütmesini sağlar. Webhook ilgili olayda bildirim gönderir; son durum için yetkili rezervasyon detayı tekrar okunur. Olaylar sıra garantisiyle gelmediğinden sadece son ulaşan webhook adına göre karar verilmez. Biri talep başlatır, diğeri sonucu haber verir; günlük akışın iki sistemde de aynı kalması bu bağlantının doğru kurulmasına bağlıdır.
Geliştirmeyi ayrı sonuçlara ayırın: yetkili restoran listesi, başarılı müsaitlik sorgusu, test rezervasyonunun oluşturulması ve webhook sonrası güncel kaydın yeniden okunması. Finansal işlemlerde confirm ve finalize ayrımını rezervasyon API akış rehberinde inceleyin. Webhook imzası, tekrar teslim ve sıralama durumlarını teknik entegrasyon dokümantasyonuyla test edin.
Canlı geçişi doğrulamayla tamamlayın
Test ortamındaki akış doğrulanmadan canlı anahtarlarına geçilmez. Son kontrolde müsaitlik yanıtının beklenen sonucu verdiğini, oluşturulan rezervasyonun doğru restorana ve saate yazıldığını, durum bildirimlerinin sisteminizde işlendiğini görürsünüz. Hatalı istek, dolu slot veya geçici kesinti karşısında kullanıcıya gösterilecek mesajlar da bu kontrolde belirlenir.
Canlı ortamda istek ve webhook sonuçlarını takip etmek için izleme sorumlularını önceden belirleyin; loglara erişim ve saklama kapsamını projeye göre netleştirin. İstek limitlerini partner ve kurulum koşullarına göre teyit edin. Kendi senaryonuz için Partner API ürün sayfasından görüşme planlayabilir, kurumsal restoran ağı modelini Guest Network üzerinden değerlendirebilirsiniz.
