Портал за разработчициХотелски софтуер HMS

Свържете софтуера си с модулите на HMS

Отделна API документация за всеки модул на хотелския софтуер: резервационна система, Wi-Fi за гости, ресторантски POS, спа, TV, телефонна централа и услуги с изкуствен интелект. Online Booking и Hotspot API вече са публикувани; останалите предстоят.

Удостоверяване
Bearer токен или заглавка ApiKey
Формат
JSON отговори с обвивка success
Налично
2 продукта · 17 крайни точки
Очаква се
5 продукта
Заявка
# Заявка за стаи и цени
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"
Отговор · 200 (съкратен)
{
    "success": true,
    "items": [
        {
            "id": 2,
            "name": "Стандартна стая",
            "roomCount": 5,
            "currency": "TRY",
            "accommodationTypes": [
                {
                    "id": 2,
                    "title": "Нощувка със закуска",
                    "prices": {
                        "2-1": {
                            "total": 2,
                            "price": "1930.00",
                            "nonRefundable": ""
                        },
                        "2-0": {
                            "total": 2,
                            "price": "1737.00",
                            "nonRefundable": "[NR]"
                        }
                    }
                }
            ]
        }
    ],
    "count": 1
}

Продукти

Всеки продукт има собствена документация, API справочник и примерен код. Предстоящите се обявяват в дневника на промените, когато бъдат публикувани.

Налично

Online Booking

API за резервационна система

Свързва резервационната система на уебсайта на хотела с HMS: списък със стаи и цени, наличност в календара, купони, плащане и изпращане на резервации.

8 ресурса · 16 крайни точкиДокументация
Налично

Hotspot

Wi-Fi за гости и записи по Закон № 5651

Предоставя на hotspot системата списъка с настанените гости: стая, самоличност, час на настаняване и напускане. За проверка на входа в Wi-Fi мрежата за гости по номер на стая и за водене на записите за достъп по турския Закон № 5651.

1 ресурс · 1 крайна точкаДокументация
Очаква се

Ресторантски POS

Сметки и начисления към стаята

Прехвърляне на сметки от ресторант, бар и кафе към фолиото на стаята, синхронизация на менюто и складовите наличности.

Документацията се подготвя
Очаква се

Spa

Записване на часове и услуги

Записване на часове за спа и уелнес, каталог с услуги и интеграция за начисляване към стаята.

Документацията се подготвя
Очаква се

Изкуствен интелект

Услуги за асистент и препоръки

Достъп до услуги с изкуствен интелект за асистент на гостите, препоръки за цени и отчети.

Документацията се подготвя
Очаква се

TV

TV системи в стаите

Данни за госта, фолио, съобщения и заявки за услуги за TV интерфейса в стаята.

Документацията се подготвя
Очаква се

Телефонна централа

Централа и регистър на разговорите

Интеграция с телефонната централа: включване и изключване на линии при настаняване/напускане, начисляване на разговорите към фолиото.

Документацията се подготвя

Общи принципи за всички продукти

След като интегрирате един модул, останалите ще ви бъдат познати.

Ключ, обвързан с хотела

В Online Booking издадените от HMS apiKey/apiSecret се разменят срещу Bearer токен, обвързан с хотела и валиден 7 дни. Интеграциите в самия хотел, като Hotspot, използват ключ, генериран в собствения панел на хотела, който се изпраща в заглавката ApiKey при всяка заявка.

Удостоверяване

Обвивка success

Отговорите са в JSON и съдържат флаг success. Грешките от бизнес правилата се връщат като HTTP 200 с message или errorCode; грешките при удостоверяване са 401.

Заявки и отговори

Работещи примери

За всяка крайна точка се генерират примери на cURL, Node.js и PHP; копирайте ги, добавете ключа си и ги изпълнете.

API справочник
  • Сайт
    Поддръжка на 22 езика
    НовоНово
  • Hotspot
    Публикувана е документацията на Hotspot API
    НовоНово
  • Online Booking
    Публикувана е документацията на Online Booking API
    НовоНовоНово

Нужна ви е помощ?

Екипът ни от разработчици отговаря в рамките на един работен ден.

Приложете тялото на заявката (с маскирани тайни ключове и данни на карти), отговора и часа. Използвайте същия адрес за партньорски ключове, тестови хотели и ранен достъп.