支持
集成过程中遇到任何阻碍，都可以联系我们的开发团队。建议先查看该产品的错误码页面；大多数问题都能在那里找到答案。
合作伙伴密钥
访问 API 需要 HMS 签发的合作伙伴账户。请通过邮件发送贵公司信息及拟集成的酒店；您将收到用于测试环境的 apiKey、apiSecret 和一个酒店 ID。
报告问题时，请提供
- 产品和端点（例如 Online Booking ·
POST /external/online/roomType） - 完整的请求体和响应，其中
apiSecret、token 和卡数据需脱敏 - 请求发送时间（含时区）及
hotelID - 预期结果，以及问题能否复现
常见问题
使用 API 需要什么？
HMS 签发的合作伙伴账户（apiKey / apiSecret），以及您所集成酒店对该账户的授权。酒店一侧还必须启用相应模块（例如在线预订渠道）。
有测试环境吗？
有。本文档中的示例使用测试环境（test.hms.gen.tr）；开发时会为您提供该环境的酒店记录和合作伙伴密钥。集成通过审核后，会向您提供生产环境地址和密钥。
我收到了 401。
token 缺失、已过期、缺少 Bearer 前缀，或属于其他酒店。请重新登录后重试。如果登录返回 success: false，请查看 message：密钥对错误，或没有该酒店的授权。
房型列表为空，或 roomCount 为 0。
酒店的在线渠道已关闭（errorCode 10003）、没有开放销售的房型（10004），或受日期/入住人数限制。对于 roomCount 为 0 的房型，roomRestrictionMessage 会说明原因（最短入住晚数、禁止入住、未设置价格）。
我推送了预订，但后台看不到。
检查 BookingPushRS 中是否有 Error。Hotel registration not found on HMS. 表示酒店未接入在线渠道；Could not register. 通常表示 roomTypeID / ratePlanID 无效或日期不一致。
其他模块的 API 何时发布？
餐厅 POS、Spa、AI、TV 和电话交换机的文档正在陆续添加。发布日期会在更新日志中公布；如需抢先体验某个模块，请联系我们。