RoomFollow · Mobile API v1
Mobil uç kataloğu.
iOS için mevcut 66 yöntem/yol eşleşmesi. Temel adres: https://app.roomfollow.com/api/mobile/v1.
19 Eylül 2026 · Katalog, route dosyalarıyla otomatik testte karşılaştırılır; yeni veya kaldırılan uçta test güncelleme gerektirir.
Bildirimler
/notificationsBearer oturumuna ait son 100 bildirim, okunmamış sayısı, tercihler ve push durumu. İçerik güncel otel yetkileriyle filtrelenir. kind: reservation, morning, daily, weekly, hourly, kbs (KBS misafir/personel bildirimi gecikmesi veya bağlantı sorunu; sorun sürdükçe 15 dk’da bir yinelenir, çözülünce “KBS sorunu çözüldü”; kişisel veri içermez) veya night_audit (geciken gün sonu; yalnız night_audit.run).
/notifications/settingsBu cihaz oturumunun bildirim türlerini ve otelin yerel saatine göre özet saatlerini kaydeder.
/notifications/deviceAPNs token ve sandbox/production ortamını kayıt eder; token sunucuda şifrelenir.
/notifications/readid veya all:true ile yalnız bu oturumdaki bildirimleri okundu işaretler.
Otel operasyonu
/cashierSalt okunur resepsiyon kasası; day=YYYY-MM-DD. cashier.read gerekir; detaylar webdeki resepsiyon/müdür rol kapsamına bağlıdır.
/blocksfrontdesk.read; iş gününden sonraki 90 gün için oda atamaları ve blokajlar.
/dashboardDashboard göstergeleri; finansal alanlar rol yetkisine bağlıdır.
/overviewOperasyon özeti.
/roomsOda planı ve durumlar.
/rooms/{roomId}/notesfrontdesk.read; tesise ait odanın en son 100 notu.
/rooms/{roomId}/notesfrontdesk.read + reservation.update; body alanıyla 1–1000 karakter oda notu.
/guestsfrontdesk.read; tesise bağlı kayıtlı misafirler, 100 kayıtlık sayfalar; offset ve nextOffset ile devam edilir.
/frontdeskÖn büro hareketleri.
/frontdesk/{stayId}/check-inCheck-in ön bilgileri.
/frontdesk/{stayId}/check-inCheck-in işlemini gerçekleştirir.
/frontdesk/{stayId}/check-outCheck-out ön kontrolleri.
/frontdesk/{stayId}/check-outCheck-out işlemini gerçekleştirir.
Oturum
/healthHerkese açık servis sağlık bilgisi; otel verisi içermez.
/auth/loginTesis kodu, e-posta, parola ve cihaz bilgisiyle giriş. Yalnız otel hesapları; Garsonup hesapları genel hata alır. Yönetici bir sonraki girişte şifre değişikliği istediyse kullanıcı web panelinde yeni şifre belirleyene kadar giriş açıklayıcı mesajla reddedilir.
/auth/verifyEtkinse ikinci adım doğrulama kodunu tamamlar.
/auth/refreshGeçerli refresh token ile oturumu yeniler; token döndürülür ve eskisi geçersizleşir.
/auth/logoutBearer oturumunu iptal eder.
Hesap ve ekip
/accountOturumdaki kullanıcı ve tesis hesabı.
/account/photoBearer oturumuna ait kullanıcının profil fotoğrafı; binary image, no-store; fotoğraf yoksa 404.
/account/passwordParola değiştirme. Yeni parola en az 6 karakterdir; yalnız rakam da olabilir (en fazla 72 bayt, başta/sonda boşluk yok). Başarılı değişim bekleyen zorunlu değişikliği ve açık sıfırlama bağlantısını kapatır.
/teamYetki kapsamındaki tesis ekibi.
/teamYetkili kullanıcı tarafından ekip üyesi oluşturma.
/team/{membershipId}Ekip üyeliği ve yetki işlemleri.
Rezervasyon
/reservationsquery, status, start/end (YYYY-MM-DD; konaklama çakışması) ve offset ile rezervasyon listesi; sayfa 100 kayıt, nextOffset null ise son sayfa.
/reservationsYeni rezervasyon oluşturma.
/reservations/optionsTesisin oda tipi, fiyat ve form seçenekleri.
/reservations/{reservationId}Rezervasyon ayrıntıları.
/reservations/{reservationId}operation ile düzenleme, oda atama, iptal veya no-show işlemi. NO_SHOW yalnız geliş tarihi tesis iş gününe ulaşmış rezervasyonda yapılır; aksi hâlde 409 reservation_action_failed. Fiyat planında iptal / no-show cezası tanımlıysa NO_SHOW ve ücretsiz iptal süresi geçmiş CANCEL işlemi oda folyosuna ceza satırı yazar (yanıt gövdesi değişmez).
/identity-scanYetkili personel için multipart kimlik/pasaport okuma. Yanıt okunan alanlar, confidence ve uncertainFields içerir; uncertainFields'teki alanları kullanıcıya belgeyle karşılaştırtın.
Kat hizmetleri
/housekeepingTemizlik görevleri ve oda durumları.
/housekeeping/{roomId}Temizlik başlatma, bitirme, kontrol ve yetkili görevli atama (ASSIGN, assignedToId, notes).
/housekeeping/{roomId}/dndRahatsız etmeyin durumu.
/maintenanceBakım ve arıza kayıtları.
/maintenanceBakım kaydı oluşturma.
/maintenance/{requestId}Bakım kaydının durumunu güncelleme.
Raporlar ve gün sonu
/forecastyear, month ve includeOptions ile aylık forecast; günlük adults, children ve people dahil; report.read gerekir.
/reportsYetkiye göre rapor kataloğu ve geçmişi. catalog=reference yalnızca gerçek veriyle çalışan katalog raporlarını ve parametre alanlarını (form) döndürür; giriş kayıtları audit.read ister.
/reportscatalogCode ile web rapor hesaplamaları; start/end, currency, detaylı gelir seçenekleri ve katalog formundaki ek alanlar (ör. nationality, groupBy, windowDays). Hücreler Türkçe görüntü etiketidir. Hazırlanan raporlar 400 report_not_ready döner. En çok 10.000 satır; truncated kısmi sonuçları belirtir. Eski çağrılar 60 satırlık önizlemeyi korur.
/night-auditManuel gün sonu ön kontrolü.
/night-auditexpectedBusinessDate ile yetkili manuel kapanış.
Kimlik bildirimi (KBS)
/kbs-bridge/pendingRoomFollow Windows programı Polis KBS köprüsü: bekleyen giriş/çıkış/oda değişikliği bildirimleri. dryRun=1 kayıt kiralamaz; kimlik numarası yalnız bu yanıtta çözülür. canOperateKbs gerekir.
/kbs-bridge/inhousePortal karşılaştırması için içerideki misafirler (kimlik numarasının yalnız son 2 hanesi).
/kbs-bridge/resultsPortal sonuçları; kayıt yalnız SENT ile kurum kabul etti olur. Tekrar gelen sonuç duplicate döner, deneme modu 422.
/kbs-bridge/reconcileTur özeti (KBS / İçeride / Hatalı) ve portal karşılaştırması; eksikler kuyruğa alınır.
Folyo
/foliosYetkili folyo listesi.
/folios/optionsFolyo işlem seçenekleri.
/folios/{folioId}Folyo ayrıntısı.
/folios/{folioId}/chargesYetkili folyo harcama kaydı.
/folios/{folioId}/paymentsYetkili folyo tahsilatı.
Restoran
/posRestoran, masa, menü ve adisyon verileri. Adisyon ödemelerinin kind alanı web POS'ta odaya (ROOM_CHARGE) veya cariye (CITY_LEDGER) yazılan ödemeler için bu değerleri alabilir; iptal satırı negatif tutarlıdır.
/pos/checksAdisyon oluşturma.
/pos/checks/{checkId}/linesAdisyon kalemleri.
/pos/checks/{checkId}/kitchenMutfağa gönderme.
/pos/checks/{checkId}/settlementsYetkili adisyon tahsilatı (yalnız CASH ve CREDIT_CARD; sözleşme değişmedi). Odaya / cariye yazma mobil API'de yoktur.
SPA
/spaHizmet, kaynak ve randevu verileri. Ödeme kind değeri CASH / CREDIT_CARD dışında web panelinden yazılan ROOM_CHARGE / CITY_LEDGER ve eşit negatif *_REVERSAL olabilir.
/spa/appointmentsRandevu oluşturma.
/spa/appointments/{appointmentId}/statusRandevu durumu.
/spa/appointments/{appointmentId}/paymentsYetkili SPA tahsilatı.
Entegrasyon operasyonu
/channelsrate.read: yalnız etkin CHANNEL_HUB şirket eşlemesi doğrulanmış kanal seçenekleri ve komut geçmişi; Partner API veya otel kanal kurulum kataloğu değildir.
/channelsrate.update: queueNow:false ile hedefsiz yerel taslak; queueNow:true ayrıca integration.operate ve doğrulanmış etkin hedef gerektirir.
/channels/{commandId}Yetkili kanal komutu işlemi.