RoomFollowDevelopers

RoomFollow Connectivity API

Müsaitlik

Oda tipi bazında günlük satılabilir envanteri okuyun ve tarih sınırlarını doğru uygulayın.

GET
/properties/{propertyCode}/availability?from=YYYY-MM-DD&to=YYYY-MM-DD

Başlangıç ve bitiş tarihleri zorunludur.

Örnek istekUTF-8
curl "https://app.roomfollow.com/api/v1/properties/EXAMPLE/availability?from=2026-09-01&to=2026-09-07" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
  • Tarihler tesisin yerel takvimine göre değerlendirilir.
  • Sonuç oda tipi bazında hesaplanır; fiziksel oda numarası paylaşılmaz.
  • Satışa kapalı veya blokajlı envanter müsait adetten düşülür.
  • from dahil, to hariçtir. En fazla 366 gece; geçersiz takvim tarihleri 400 döndürür.

Oda ve fiyat planı kataloğu

GET
/properties/{propertyCode}/catalog

property.read yetkisi gerekir. data.roomTypes içinde id, code, name ve kişi kapasiteleri; data.ratePlans içinde id, code, name, currency ve boardType döner. Kimlikler yalnız jetonun tesisine aittir. Her oda tipinin photos dizisi id, caption, mimeType, width, height, size, sortOrder, createdAt, isCover ve downloadPath alanlarını içerir. İlk fotoğraf kapaktır.

GET
/properties/{propertyCode}/photos/{photoId}

property.read yetkisiyle WebP dosyasını indirir. downloadPath aynı bearer jetonuyla çağrılır; halka açık fotoğraf adresi değildir. Bulunamayan fotoğraf 404, geçersiz jeton 401, yanlış tesis veya kapsam 403 döndürür. Yanıt private/no-store olarak sunulur. Yükleme ve silme panelden yapılır. Dış kanala fotoğraf gönderimi henüz etkin değildir.

Günlük fiyatlar

GET
/properties/{propertyCode}/rates?roomTypeCode=STD&ratePlanCode=BAR&from=2026-10-01&to=2026-10-03

inventory.read yetkisi gerekir. İki kod ve iki tarih zorunludur. Fiyat oda başına gecelik toplamdır; her yetişkin sayısı için ayrı satır döner. En yüksek öncelikli sezon kullanılır.

Fiyat yanıtı örneğiUTF-8
{
  "data": [
    {
      "date": "2026-10-01",
      "adults": 2,
      "amountMinor": 11050,
      "extraAdultMinor": 0,
      "status": "READY"
    }
  ],
  "meta": {
    "schemaVersion": "1.0",
    "propertyCode": "EXAMPLE",
    "roomTypeCode": "STD",
    "ratePlanCode": "BAR",
    "currency": "EUR",
    "amountScale": 100,
    "boardType": "BB",
    "priceBasis": "ROOM_PER_NIGHT_FOR_ADULT_OCCUPANCY",
    "from": "2026-10-01",
    "to": "2026-10-03",
    "toExclusive": true,
    "ready": false,
    "generatedAt": "2026-09-24T09:00:00.000Z"
  }
}

Örnek yanıtın data dizisi kısaltılmıştır. amountMinor / amountScale ana para birimindeki tutardır (11050 / 100 = 110,50 EUR). Döviz dönüşümü yapılmaz. boardType pansiyon kodudur.

MISSING_RATE, AMBIGUOUS_RATE veya INVALID_RATE satırlarında tutarlar null döner. ready yalnız bütün satırlar READY ise true olur; eksik fiyatı sıfır olarak göndermeyin. Aynı öncelikli çakışan sezonlar otomatik seçilmez. Bilinmeyen oda/fiyat planı 404; geçersiz kapasite 409 döndürür.