概览

Online Booking API 将酒店官网上的预订引擎与 HMS 酒店管理软件对接。房型与价格列表、日历房态、优惠券验证、支付步骤以及将预订写入 HMS，全部通过此 API 完成。它面向开发预订引擎的代理商和 HMS 合作伙伴。

基础 URL#

所有端点都位于下方基础 URL 的 /external/… 路径下，仅支持 HTTPS。

API 基础 URL

https://test.hms.gen.tr

1登录POST /external/public/login

2房型与价格POST /external/online/roomType

3支付POST …/payment/type/{type}

4预订POST …/channel/booking

登录获得的 token 有效期为 7 天，并绑定一家酒店。房型列表返回客人所搜索日期和入住人数下的可售房间及价格；客人完成选择、支付方式确定后，预订以 BookingPushRQ 的形式写入 HMS。预订流程指南逐步介绍了每个环节。

资源	端点
身份验证	POST `/external/public/login`
房型与价格	POST `/external/online/roomType` GET `/external/room/type/hotel/availability`
预订	POST `/external/online/channel/booking`
支付	GET `/external/online/payment/type` GET `/external/payment/company` POST `/external/online/payment/type/{paymentType}`
优惠券	POST `/external/online/coupon/search`
套餐与附加服务	GET `/external/stock/packages`
酒店信息	GET `/external/hotel/{hotelID}/contact/info` GET `/external/online/social/media` GET `/external/online/footer` GET `/external/online/mail/host`
基础数据	POST `/external/counties` GET `/external/currencies` GET `/external/languages`

除登录外，每个请求都需携带 Authorization: Bearer <token> 请求头。
大多数 POST 端点接收表单字段（application/x-www-form-urlencoded 或 multipart/form-data），预订推送和支付发起则要求 JSON 请求体。具体格式见各端点的参考页面。
响应为 JSON，并带有 success 标志。业务规则错误同样以 HTTP 200 返回；请根据 success 而非状态码判断结果。
日期格式为 YYYY-MM-DD，金额为保留两位小数的字符串（"965.00"），币种取自酒店在线渠道的设置。
hotelID 参数必须与 token 所绑定的酒店一致。

本文档适用于 HMS API V2。新字段和新端点可能会在不另行通知的情况下加入；请让您的客户端忽略未知字段。变更记录见更新日志。