RoomFollow Connectivity API
API teknik referansı
RoomFollow API uçlarını, gerekli yetkileri ve istek biçimlerini okunabilir bir ekranda inceleyin.
Temel adres
https://app.roomfollow.com/api/v1Kimlik doğrulama
/oauth/tokenClient Credentials ile 15 dakikalık erişim jetonu üretir.
Okuma uçları
/properties/{propertyCode}/catalogproperty.read: etkin oda tipleri, kapasiteler, oda fotoğrafları ve fiyat planları.
/properties/{propertyCode}/photos/{photoId}property.read: tesis kapsamlı WebP fotoğraf dosyası. Kimlik doğrulama zorunludur.
/properties/{propertyCode}/ratesinventory.read: from, to, roomTypeCode ve ratePlanCode ile günlük fiyat matrisi. Ayrıntılar Müsaitlik rehberindedir.
/capabilitiesİstemci kapsamlarını ve etkin sağlayıcı yeteneklerini döndürür.
/properties/{propertyCode}/availabilityTarih aralığında oda tipi bazında müsaitliği döndürür.
/properties/{propertyCode}/reservationsGüncellenen rezervasyonları imleçli olarak döndürür.
/properties/{propertyCode}/mappingsOda tipi ve fiyat planı eşleştirmelerini döndürür.
HotelsFollow test kanalı
/properties/{propertyCode}/hotelsfollow/offersinventory.read: from, to (hariç), adults (1–6). En fazla 30 gece, bir oda. Yalnız İstanbul’da yayını açılan tesisler. Her gece için HotelsFollow fiyat emri gerekir; genel rates ucundaki baz fiyat otomatik yayımlanmaz.
/properties/{propertyCode}/hotelsfollow/bookingsreservations.write ve tesise özel HotelsFollow istemcisi gerekir. Idempotency-Key, gövdedeki requestKey UUID ile aynı olmalıdır. travelerId sunucudaki doğrulanmış misafir oturumundan alınır. expectedTotal, currency ve teklifin conditionsVersion değeri tekrar doğrulanır. PMS rezervasyonu, stok ve aktarım kaydı aynı işlemde tamamlandıktan sonra 201 döner. Fiyat/koşul değişikliği veya son oda çakışması 409 döner. Aynı başarılı isteğin tekrarı yeni rezervasyon yaratmaz.
Yazma ucu
/properties/{propertyCode}/reservation-eventsYeni, değişen veya iptal edilen rezervasyon olaylarını güvenli kuyruğa alır.
Webhook olayları (RoomFollow → sizin sunucunuz)
reservation.created, reservation.updated, reservation.cancelled, guest.checked_in, guest.checked_out, folio.payment_posted, invoice.issued, availability.changed. İmzalı POST istekleri; ayrıntılar Webhook olayları sayfasında ve OpenAPI belgesinin webhooks bölümündedir.