ROOMFOLLOW / DEVELOPERS

Bir otel. Birbirine bağlı sistemler.

Kanal bağlantılarından iOS uygulamasına: doğru veriye, doğru yetkiyle erişin. Partner entegrasyonları ve mobil operasyonlar için ayrı, açık rehberler.

Erişim modeliOtel panelinden self-servis
Partner sözleşmesiv1 beta · imzalı webhook
Canlı yazmaPlatform genelinde kontrollü

Neyi çözüyor?

Her sağlayıcı için otel yazılımını yeniden yazmak yerine, bütün bağlantılar ortak bir sözleşmeden geçer. Oda ve fiyat kodları sağlayıcı bazında eşleştirilir; rezervasyonlar aynı güvenli kuyruğa girer.

Çok sağlayıcılı yapı

Booking.com veya Expedia ile sınırlı değildir. Sertifikasyon tamamlanan her sağlayıcı aynı adaptör modeline eklenebilir.

Tesis izolasyonu

Bir istemci yalnız kendisine tanımlanan tesis ve yetkilere erişir. Otel verileri ortak token veya sorguyla karışmaz.

Güvenli tekrar deneme

Yazma işlemlerinde idempotency anahtarı aynı rezervasyonun iki kez oluşmasını engeller.

Kısa ömürlü erişim

Kalıcı API şifresi isteklerde taşınmaz. Client Credentials ile 15 dakikalık erişim jetonu üretilir.

İlk bağlantı

Tesis müdürü panelde Entegrasyonlar → API erişimi ekranından tesis kapsamlı bir client_id ve yalnız bir kez gösterilen client_secret üretir. İş ortağı entegrasyonlarında istemciyi RoomFollow da açabilir. Değişiklikleri anında almak için aynı ekrandan imzalı webhook adresi eklenir.

Erişim jetonu alUTF-8
curl -X POST https://app.roomfollow.com/api/v1/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -u "rf_client_xxx:rf_secret_xxx" \
  -d "grant_type=client_credentials"

Temel uçlar

GET
/properties/{propertyCode}/catalog

Eşleştirilecek etkin oda tiplerini ve fiyat planlarını okuyun (property.read).

GET
/properties/{propertyCode}/rates

Oda tipi ve fiyat planı için günlük yetişkin doluluğu fiyatlarını, para birimini ve eksik fiyatları okuyun (inventory.read).

GET
/properties/{propertyCode}/availability

Tarih aralığında oda tipi bazında müsaitliği okuyun.

GET
/properties/{propertyCode}/reservations

Güncellenen rezervasyonları imleçli biçimde çekin.

GET
/properties/{propertyCode}/mappings

Tesis, oda tipi ve fiyat planı eşleştirmelerini okuyun.

POST
/properties/{propertyCode}/reservation-events

Yeni, değişen veya iptal edilen rezervasyon olaylarını kuyruğa alın.

RoomFollow’dan size: rezervasyon, giriş/çıkış, tahsilat, fatura ve müsaitlik değişiklikleri için imzalı webhook olayları. Ayrıntılar: Webhook olayları.