Свържете софтуера си с модулите на 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"# Списък с настанените гости
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": "Стандартна стая",
"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
}{
"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
}
]
}Продукти
Всеки продукт има собствена документация, API справочник и примерен код. Предстоящите се обявяват в дневника на промените, когато бъдат публикувани.
Online Booking
API за резервационна система
Свързва резервационната система на уебсайта на хотела с HMS: списък със стаи и цени, наличност в календара, купони, плащане и изпращане на резервации.
Hotspot
Wi-Fi за гости и записи по Закон № 5651
Предоставя на hotspot системата списъка с настанените гости: стая, самоличност, час на настаняване и напускане. За проверка на входа в Wi-Fi мрежата за гости по номер на стая и за водене на записите за достъп по турския Закон № 5651.
Ресторантски 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 APIНовоНово
-
Публикувана е документацията на Online Booking APIНовоНовоНово
Нужна ви е помощ?
Екипът ни от разработчици отговаря в рамките на един работен ден.
Приложете тялото на заявката (с маскирани тайни ключове и данни на карти), отговора и часа. Използвайте същия адрес за партньорски ключове, тестови хотели и ранен достъп.