HMS modüllerine kendi yazılımınızdan bağlanın
Otel programının her modülü için ayrı API dokümantasyonu: rezervasyon motoru, misafir Wi-Fi, restoran POS, spa, TV, santral ve yapay zeka servisleri. Online Booking ve Hotspot API’leri yayında; diğerleri sırayla eklenecek.
- Kimlik doğrulama
Bearertoken veyaApiKeybaşlığı- Biçim
- JSON yanıt,
successzarfı - Yayında
- 2 ürün · 17 uç nokta
- Hazırlanıyor
- 5 ürün
# Oda ve fiyat sorgusu
curl "https://test.hms.gen.tr/external/online/roomType" \
-H "Authorization: Bearer $HMS_TOKEN" \
-d "hotelID=1000" -d "startDate=2026-08-18" -d "endDate=2026-08-20" \
-d "adultCount=2"# Oteldeki misafir listesi
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
-H "ApiKey: $HMS_API_KEY" \
-H "HotelCode: 1000"{
"success": true,
"items": [
{
"id": 2,
"name": "Standart Oda",
"roomCount": 5,
"currency": "TRY",
"accommodationTypes": [
{
"id": 2,
"title": "Kahvaltı Dahil",
"prices": {
"2-1": {
"total": 2,
"price": "1930.00",
"nonRefundable": ""
},
"2-0": {
"total": 2,
"price": "1737.00",
"nonRefundable": "[NR]"
}
}
}
]
}
],
"count": 1
}{
"success": 1,
"otelde": [
{
"unique": 58211,
"firstName": "AYŞE",
"lastName": "DEMİR",
"identityNumber": "11111111110",
"birthDate": "14.03.1985",
"roomName": "104",
"checkin": 1788863400,
"checkout": 1788998400,
"rezervasyon_id": 282799
}
]
}Ürünler
Her ürünün kendi dokümantasyonu, API referansı ve kod örnekleri var. Hazırlanmakta olanlar yayınlandığında sürüm notlarında duyurulur.
Online Booking
Rezervasyon motoru API’si
Otelin web sitesindeki rezervasyon motorunu HMS’e bağlar: oda ve fiyat listesi, takvim müsaitliği, kupon, ödeme ve rezervasyon aktarımı.
Hotspot
Misafir Wi-Fi ve 5651 kayıt
Oteldeki misafir listesini hotspot sistemine verir: oda, kimlik, giriş ve çıkış zamanı. Misafir Wi-Fi girişinin oda numarasıyla doğrulanması ve 5651 sayılı kanun kayıtları için.
Restoran POS
Adisyon ve odaya yazma
Restoran, bar ve kafe adisyonlarının oda folyosuna aktarılması, menü ve stok senkronu.
Spa
Randevu ve hizmet satışı
Spa ve wellness randevuları, hizmet katalogu ve odaya yazma entegrasyonu.
Yapay Zeka
Asistan ve öneri servisleri
Misafir asistanı, fiyat önerisi ve raporlama için yapay zeka servislerine erişim.
TV
Oda içi TV sistemleri
Oda TV arayüzü için misafir bilgisi, folyo, mesaj ve hizmet talebi entegrasyonu.
Santral
PBX ve çağrı kayıtları
Telefon santrali entegrasyonu: check-in/out ile hat açma-kapama, arama ücretlerinin folyoya yazılması.
Tüm ürünlerde ortak ilkeler
Bir modülü entegre ettiyseniz diğerleri tanıdık gelecek.
Otele bağlı anahtar
Online Booking’de HMS’nin verdiği apiKey/apiSecret ile otele bağlı, 7 gün geçerli bir Bearer token alınır. Hotspot gibi otel içi entegrasyonlarda anahtar otelin kendi panelinden üretilir ve her istekte ApiKey başlığında gönderilir.
success zarfı
Yanıtlar JSON’dur ve success alanı taşır. İş kuralı hataları HTTP 200 içinde message ya da errorCode ile döner; kimlik doğrulama hataları 401’dir.
Çalışan örnekler
Her uç nokta için cURL, Node.js ve PHP örnekleri tanımlardan üretilir; kopyalayıp anahtarınızı koyarak çalıştırabilirsiniz.
API referansıSon değişiklikler
-
Hotspot API dokümantasyonu yayınlandıYeniYeni
-
Online Booking API dokümantasyonu yayınlandıYeniYeniYeni
-
hmsdev.com açıldıYeni
Takıldınız mı?
Geliştirici ekibimiz hafta içi bir iş günü içinde yanıt verir.
Bildirimlere isteğin gövdesini (gizli anahtarlar ve kart verisi maskelenmiş), yanıtı ve zamanı ekleyin. İş ortağı anahtarı, test oteli ve erken erişim talepleri için de aynı adres.