开发者门户HMS 酒店管理软件
将您的软件接入 HMS 各模块
为酒店管理软件的每个模块提供独立的 API 文档:预订引擎、客人 Wi-Fi、餐厅 POS、Spa、TV、电话交换机和 AI 服务。Online Booking 和 Hotspot API 现已上线,其余模块将陆续推出。
- 身份验证
Bearertoken 或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 对接:房型与价格列表、日历房态、优惠券、支付和预订推送。
8 个资源 · 16 个端点文档
已上线
Hotspot
客人 Wi-Fi 与 5651 日志
向热点系统提供在住客人名单:房间、身份信息、入住和退房时间。用于通过房间号验证客人的 Wi-Fi 登录,并按土耳其第 5651 号法律留存访问日志。
1 个资源 · 1 个端点文档
即将推出
餐厅 POS
账单与挂房账
将餐厅、酒吧和咖啡厅的账单挂入客房房账,并同步菜单和库存。
文档编写中
即将推出
Spa
预约与服务
Spa 与康体预约、服务目录以及挂房账集成。
文档编写中
即将推出
AI
助手与推荐服务
为客人助手、价格建议和报表提供 AI 服务接入。
文档编写中
即将推出
TV
客房电视系统
为客房电视界面提供客人信息、房账、消息和服务请求。
文档编写中
即将推出
电话交换机
PBX 与通话记录
电话交换机集成:随入住/退房开通和关闭线路,并将通话费用记入房账。
文档编写中
所有产品共通的原则
集成过一个模块后,其他模块也会很快上手。
最近更新
-
支持 22 种语言新增新增
-
Hotspot API 文档已发布新增新增
-
Online Booking API 文档已发布新增新增新增
遇到问题?
我们的开发团队会在一个工作日内回复。
请附上请求体(机密信息和卡数据需脱敏)、响应和请求时间。申请合作伙伴密钥、测试酒店和抢先体验,也请发送至同一地址。