Partner API, başka bir sistemin Rezervem'le konuşmasını sağlar
Bir API, iki yazılımın belirli kurallar çerçevesinde veri alışverişi ve işlem yapmasını sağlayan arayüzdür. Rezervem Partner API, yetkilendirilmiş dış sistemler için rezervasyonla ilişkili işlemleri sunar. Bu, bütün partnerlerin aynı restoranları görebildiği veya bütün işlemleri yapabildiği anlamına gelmez.
Örneğin banka uygulamasındaki kullanıcı restoran arayıp rezervasyon oluşturmak isterken, POS sağlayıcısı o akşam masaya alınmış rezervasyonun servis kaydını eşleştirmek ister. Kullanım amaçları farklı olduğu için teknik yetkiler de farklıdır.
Guest Network partnerleri ne yapar?
Guest Network partnerleri, yetkilendirildikleri restoranları listeleyebilir, müsaitliği sorgulayabilir ve uygun izinlerle rezervasyon oluşturma akışını yürütebilir. Otel, concierge, banka, medya veya yaşam tarzı uygulamasında misafirin başladığı işlem Rezervem'deki rezervasyon akışına bağlanır. Restoran listesi ve rezervasyon oluşturma erişimi partner koşullarına bağlıdır.
Bu akış her zaman tek çağrıyla bitmez. Seçim, hold, confirm ve gerektiğinde ödeme/finalize adımlarını kapsar. Restoran listesi, rezervasyon oluşturma ve misafir bilgilerini görüntüleme hakları ayrı ayrı değerlendirilir; global partnerlerde canlıya geçiş için ayrıca onay gerekebilir.
POS partnerleri ne yapar?
POS partnerinin temel görevi yeni bir rezervasyon kanalı açmak değil, restorandaki mevcut rezervasyonları servis işlemleriyle ilişkilendirmektir. Yetkileri kapsamında rezervasyon okuma, check-in/check-out ve ilgili masa veya hesap işlemleri bu modele girer. POS türünde erişim sahibi olmak, Guest Network rezervasyon oluşturma yetkisi vermez.
Bir entegrasyon tasarlarken ‘POS satış kaydı’, ‘rezervasyon oluşturma’ ve ‘ödeme’ terimlerini aynı işlem gibi kullanmayın. Hangi işlemin hangi sistemde yapıldığı ve sonucunun nerede tutulduğu projeye başlarken netleştirilmelidir.
Webhook ve misafir erişimi nasıl çalışır?
REST API, yetkili işlemi başlatmak veya mevcut kaydı okumak için kullanılır. Webhook ise ilgili olay gerçekleştiğinde partner sistemine haber verir. Webhook ile değişikliği öğrendiğinizde güncel rezervasyon durumunu API'den yeniden okuyun; bildirim sırasına veya yalnız olay adına güvenmeyin.
Misafirin telefon ve e-posta bilgileri ayrıca erişim iznine bağlıdır. Restoranın iç notları gibi bazı alanlar Guest Network partnerlerine açılmaz. Misafir bilgisini teknik olarak okuyabilmek, onu pazarlama için kullanma yetkisi vermez.
Partner API, Guest Network ve Manager arasında nasıl seçim yapılır?
İhtiyacınız tek bir restoranın rezervasyonlarını yönetmekse Rezervem Manager üzerinden ilerleyebilirsiniz. Google, WhatsApp, Oracle Simphony Cloud gibi desteklenen hazır bağlantılardan biri işinizi karşılıyorsa özel bir entegrasyon kurmanız gerekmez. Yalnızca restoran web sitenize rezervasyon formu eklemek istiyorsanız online rezervasyon ekleme rehberi başlangıç için yeterlidir.
Kendi uygulamanızın veya platformunuzun Rezervem’den müsaitlik alması, rezervasyon göndermesi ve durum değişikliklerini takip etmesi gerekiyorsa kullanım senaryonuzu netleştirin. Hangi sistem konuşacak, hangi veri hangi yönde akacak ve kullanıcı hangi sonucu görecek? Bu soruların yanıtıyla Partner API entegrasyonuna nasıl başlanır rehberine ilerleyebilir, ardından Partner API sayfasından görüşme talep edebilirsiniz.
