开发者门户HMS 酒店管理软件

将您的软件接入 HMS 各模块

为酒店管理软件的每个模块提供独立的 API 文档:预订引擎、客人 Wi-Fi、餐厅 POS、Spa、TV、电话交换机和 AI 服务。Online Booking 和 Hotspot API 现已上线,其余模块将陆续推出。

身份验证
Bearer token 或 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
}

所有产品共通的原则

集成过一个模块后,其他模块也会很快上手。

绑定酒店的密钥

在 Online Booking 中,用 HMS 签发的 apiKey/apiSecret 换取绑定酒店、有效期 7 天的 Bearer token。Hotspot 等酒店本地集成则使用在酒店自己后台生成的密钥,每次请求都通过 ApiKey 请求头发送。

身份验证

success 包装结构

响应均为 JSON,并带有 success 标志。业务规则错误以 HTTP 200 返回,并附带 messageerrorCode;身份验证错误返回 401。

请求与响应

可运行的示例

每个端点都提供 cURL、Node.js 和 PHP 示例;复制后填入您的密钥即可运行。

API 参考

最近更新

完整更新日志

  • 网站
    支持 22 种语言
    新增新增
  • Hotspot
    Hotspot API 文档已发布
    新增新增
  • Online Booking
    Online Booking API 文档已发布
    新增新增新增

遇到问题?

我们的开发团队会在一个工作日内回复。

请附上请求体(机密信息和卡数据需脱敏)、响应和请求时间。申请合作伙伴密钥、测试酒店和抢先体验,也请发送至同一地址。