查询酒店房态日历
查看 Booking 酒店与旅行数据 的全部接口 →以数字 hotel_id 查询文档所述的日历，可附起始 checkin_date、rooms、children_age、currency_code 与 language_code。该接口没有 adults 或 checkout_date，不要照搬酒店详情参数。实际响应、日历覆盖范围、每日状态字段和价格覆盖均未实测。返回日期仅可作为后续明确日期的酒店或房型查询候选，不代表房间已保留。
API 功能
从酒店 ID 进入日历 使用选中酒店的数字标识，而不是目的地 UFI。
指定日历起始日期 可用 checkin_date 表达查询起点。
保留日历专属人数字段 文档提供房间数和儿童年龄，没有成人数字段。
再查具体住宿条件 先核对日期条目，再查询明确日期与人数下的房型。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/booking/get-availability-calendar API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/booking/get-availability-calendar?key=<API_KEY>&hotel_id=180769'
curl -X GET 'https://api.opendata-api.com/api/project/booking/get-availability-calendar?key=<API_KEY>&hotel_id=180769'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 评估已知酒店的日历能否用于住宿日期选择器。
- 旅客调整出发日后查看候选日期。
- 比较多家已选酒店的日历范围，不假定覆盖无限未来。
- 设计价格日历格前确认实际响应是否含可用价格。
常见问题
在哪里设置日历的成人数？
该接口没有 adults。仅使用其文档参数；查询具体日期的酒店详情或房型时，再设置完整入住人数。
日历保证每个未来日期都有价格吗？
不保证。日历期限和每日价格结构均未实测，应检查实际条目并重新核对所选住宿，不能视为保证库存。