Geliştirici portalıHMS Otel Programı

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
Bearer token veya ApiKey başlığı
Biçim
JSON yanıt, success zarfı
Yayında
2 ürün · 17 uç nokta
Hazırlanıyor
5 ürün
İstek
# 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"
Yanıt · 200 (kırpılmış)
{
    "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
}

Ü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.

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.

Kimlik doğrulama

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.

İstek ve yanıt biçimi

Ç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

Tüm sürüm notları

  • Hotspot
    Hotspot API dokümantasyonu yayınlandı
    YeniYeni
  • Online Booking
    Online Booking API dokümantasyonu yayınlandı
    YeniYeniYeni
  • Site
    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.